AwrAIter MCP Server
A remote MCP server for the Telegram channels you administer: read analytics, draft posts from your own scraped sources, build content plans, schedule and publish — from inside ChatGPT, Claude, or any MCP-capable client.
Not a userbot. No phone number, no login code, no .session file. The server acts through your AwrAIter account and reaches only the channels of the team you authorize.
Русская версия · Connection guide · Tool reference · Team and invites · awraiter.ai
Server
Quick start
You need an AwrAIter account (sign in with Telegram) and at least one connected channel.
Claude (web / desktop)
Settings → Connectors → Add custom connector, paste the URL, press Connect, and confirm access for the team you want.
https://awraiter.ai/mcp
Claude Code
claude mcp add --transport http awraiter https://awraiter.ai/mcp
Agent skill (Claude Code, Codex and other agents)
The AwrAiter_skills repository ships a skill with the full tool contract, authentication, the draft → check → preview → schedule workflow and the guardrails an agent should follow:
# Claude Code — as a plugin
claude plugin marketplace add MediaZione/AwrAiter_skills
claude plugin install awraiter@awraiter
# Codex and any other agent with skills
npx skills add MediaZione/AwrAiter_skills --skill awraiter
ChatGPT
AwrAiter is not in the ChatGPT plugin catalog yet — add it as your own MCP server: Settings → Security and login → Developer mode, then chatgpt.com/plugins → +, paste the URL, keep OAuth and press Connect. In a chat, pick it from the tools menu. The ChatGPT/Codex desktop form has no OAuth option; connect it with a token instead (see below).
Clients that take a JSON config
{
"mcpServers": {
"awraiter": {
"type": "http",
"url": "https://awraiter.ai/mcp"
}
}
}
Clients without OAuth (token auth)
Create a token in the panel under MCP connection — it is shown once, together with ready-to-paste snippets (Claude Code command, JSON config, cURL, Node.js) that already contain it — and send it as a header:
Authorization: Bearer YOUR_TOKEN
Step-by-step instructions for Claude, Claude Code, ChatGPT, Codex, Gemini CLI and Qwen Code are in docs/connect.md; ready-to-paste config files are in examples/.
Tools
29 tools. The ones that change something are marked ✍️ — everything else is read-only.
What each tool returns, and the exact scope it needs, is in docs/tools.md.
Authentication
OAuth 2.1 with PKCE and dynamic client registration; redirect URIs are restricted to HTTPS or HTTP loopback, authorization codes are single-use, and refresh tokens rotate. A token is bound to one user, one team and one scope.
Personal access tokens come in two scopes:
Tokens are listed, and can be revoked, in the panel under MCP connection.
Security model
Every write goes through the same channel-level access control as the panel, and rate limits apply per token. The full model, and how to report a vulnerability, are in SECURITY.md.
About AwrAIter
AwrAIter is a panel for people who run Telegram channels: weekly content plans, AI drafts in your channel's tone, scheduled publishing, and analytics for everything published — growth, reach, ER/ERR, per-post performance, channel comparison, export to XLSX or Google Sheets. One channel is free forever; paid plans start at €9/month. See awraiter.ai.
Support and legal
- Questions and issues: awraiter.ai/support
- Terms of Service · Privacy Policy
- Operated by Mediazione Italia S.r.l. Payments are handled by Stripe; we never see card numbers.
- Your channel content stays yours — we do not train models on it unless you explicitly opt in (off by default).
License
Documentation and examples in this repository are released under the MIT License. The AwrAIter service itself is proprietary.