{
  "markdown": "# AwrAIter MCP Server\n\n[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-ai.awraiter%2Ftelegram-5A5AFF)](https://registry.modelcontextprotocol.io)\n[![Transport](https://img.shields.io/badge/transport-streamable--http-1f6feb)](https://modelcontextprotocol.io)\n[![Auth](https://img.shields.io/badge/auth-OAuth%202.1%20%C2%B7%20PKCE-2ea043)](#authentication)\n[![Docs](https://img.shields.io/badge/docs-awraiter.ai%2Fmcp--server-8957e5)](https://awraiter.ai/mcp-server/)\n\nA 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.\n\n**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.\n\n[Русская версия](README.ru.md) · [Connection guide](docs/connect.md) · [Tool reference](docs/tools.md) · [awraiter.ai](https://awraiter.ai)\n\n---\n\n## Server\n\n| | |\n|---|---|\n| **URL** | `https://awraiter.ai/mcp` |\n| **Transport** | Streamable HTTP |\n| **Authentication** | OAuth 2.1 (PKCE, dynamic client registration) or a personal access token |\n| **Registry name** | `ai.awraiter/telegram` |\n| **Availability** | Every plan, including the free tier |\n\n## Quick start\n\nYou need an AwrAIter account ([sign in with Telegram](https://awraiter.ai/login)) and at least one connected channel.\n\n### Claude (web / desktop)\n\n**Settings → Connectors → Add custom connector**, paste the URL, press **Connect**, and confirm access for the team you want.\n\n```\nhttps://awraiter.ai/mcp\n```\n\n### Claude Code\n\n```bash\nclaude mcp add --transport http awraiter https://awraiter.ai/mcp\n```\n\n### ChatGPT\n\nIn the browser, **Settings → Connectors** offers OAuth — paste the URL and press **Connect**.\nThe ChatGPT/Codex desktop form has no OAuth option; connect it with a token instead (see below).\n\n### Clients that take a JSON config\n\n```json\n{\n  \"mcpServers\": {\n    \"awraiter\": {\n      \"type\": \"http\",\n      \"url\": \"https://awraiter.ai/mcp\"\n    }\n  }\n}\n```\n\n### Clients without OAuth (token auth)\n\nCreate a token in the panel under [**MCP connection**](https://awraiter.ai/mcp-connect) — it is shown once — and send it as a header:\n\n```\nAuthorization: Bearer YOUR_TOKEN\n```\n\nStep-by-step instructions for Claude, Claude Code, ChatGPT, Codex, Gemini CLI and Qwen Code are in\n**[docs/connect.md](docs/connect.md)**; ready-to-paste config files are in **[examples/](examples/)**.\n\n## Tools\n\n25 tools. The ones that change something are marked ✍️ — everything else is read-only.\n\n| Tool | What it does |\n|---|---|\n| `list_teams` | Teams you belong to; marks the active one |\n| `switch_team` ✍️ | Switch the active team (membership is verified server-side) |\n| `list_channels` | Channels owned by the active team |\n| `get_channel` | One channel's profile: name, chat id, language, description |\n| `get_channel_stats` | Subscribers, reach, ER and dynamics over 1–90 days |\n| `get_channel_insights` | What works for this audience, scored against the channel's own 30-day median |\n| `get_recent_posts` | Most recent published posts, newest first |\n| `search_channel_content` | Semantic search over the channel's own posts and source material |\n| `search_sources` | Search the channel's bound sources |\n| `draft_from_sources` | Freshest scraped sources not yet used in a post |\n| `deep_analyze` ✍️ | Deep AI analysis of channel performance — the one tool that spends the team's AI credits |\n| `check_uniqueness` | Is this draft a near-duplicate of existing posts or a copy of a source? |\n| `score_post` | Data-grounded quality signal for a draft, specific to this channel |\n| `preview_post` | Exact message that would be sent — title, body, media, formatting |\n| `create_post_from_text` ✍️ | Save a ready-to-publish draft from text the assistant wrote |\n| `schedule_post` ✍️ | Publish a draft now, or schedule it for a given time |\n| `cancel_scheduled_post` ✍️ | Cancel a scheduled post by its plan id |\n| `get_content_plan` | The channel's plan configuration and its slots |\n| `create_content_plan` ✍️ | Create a content plan for a channel |\n| `find_free_slot` | Earliest slot in the plan with no post yet |\n| `get_channel_memory` | The channel's brand brief and banlist |\n| `set_brand_brief` ✍️ | Replace the channel's brand/tone guidance |\n| `add_banlist_entry` ✍️ | Add a forbidden word to the channel's banlist |\n| `remove_banlist_entry` ✍️ | Remove a word from the banlist |\n| `get_playbook` | Step-by-step operator playbook for a workflow |\n\nWhat each tool returns, and the exact scope it needs, is in **[docs/tools.md](docs/tools.md)**.\n\n## Authentication\n\nOAuth 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.\n\nPersonal access tokens come in two scopes:\n\n| Scope | Allows |\n|---|---|\n| `read` | Read-only tools; every ✍️ tool is refused server-side |\n| `full` | Everything the account can do in the panel |\n\nTokens are listed, and can be revoked, in the panel under [MCP connection](https://awraiter.ai/mcp-connect).\n\n## Security model\n\n|  | Userbot-style Telegram MCP servers | AwrAIter |\n|---|---|---|\n| What you hand over | Phone number, login code, session file | An OAuth grant to your own account |\n| What it can reach | Everything your account can — DMs, groups, private material | Only the channels of the team you authorized |\n| How it publishes | As you | Through the panel's own service admin, with the same permission checks as the UI |\n| If the token leaks | Your whole Telegram account | Revoke the token in the panel; nothing else is exposed |\n\nEvery write goes through the same channel-level access control as the panel, and rate limits apply per token.\nThe full model, and how to report a vulnerability, are in **[SECURITY.md](SECURITY.md)**.\n\n## About AwrAIter\n\nAwrAIter 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](https://awraiter.ai).\n\n## Support and legal\n\n- Questions and issues: [awraiter.ai/support](https://awraiter.ai/support/)\n- [Terms of Service](https://awraiter.ai/legal/terms/) · [Privacy Policy](https://awraiter.ai/legal/privacy/)\n- Operated by Mediazione Italia S.r.l. Payments are handled by Stripe; we never see card numbers.\n- Your channel content stays yours — we do not train models on it unless you explicitly opt in (off by default).\n\n## License\n\nDocumentation and examples in this repository are released under the [MIT License](LICENSE). The AwrAIter service itself is proprietary.\n",
  "bytes": 6956,
  "sha": "cf2c2ed746790eb247383c089afe9efe7d0c8b232c83ff0618d70f8d68d55ab3",
  "repo_slug": "mediazione/awraiter",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_awraiter_telegram_90ff8870/readme"
}