AwrAIter — Telegram channels

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

AI agent connecting this for someone? Follow AGENTS.md: exact commands for Claude Code, Codex, Gemini CLI and Cursor.

---

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](docs/connect.md); ready-to-paste config files are in [examples/](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](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](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.