Telegram MCP

The Telegram MCP server for AI agents

Connect Telegram to Claude, Cursor, or any MCP client. Your AI agent can search conversations, send messages, run broadcasts, and launch campaigns — in natural language, from your own accounts.

Start 7-day free trialView pricing

Give your AI agent hands on Telegram

MCP (Model Context Protocol) is the open standard that lets AI assistants use external tools. GramClaw ships a remote Telegram MCP server that turns your entire Telegram outreach workflow into tools an agent can call — so instead of clicking around, you just tell Claude “find everyone who asked about pricing this week and send them the follow-up.”

Connect it by pasting one URL into your MCP client:

https://gramclaw.com/api/mcp?key=gc_live_…

The API key both identifies you and authorizes the tools, scoped to the accounts it's allowed to act on. Revoke it anytime from Settings.

Tools the AI agent can call

1

Search & read

Search messages, list and open chats, list contacts, and pull conversation history.

2

Send messages

Start a new chat or reply in an existing one — from the right connected account.

3

Broadcast

Push a personalized message to a whole segment with safe throttling.

4

Campaigns

Create multi-step drip campaigns, then check their status and results.

5

Pipeline & CRM

Move chats between pipeline stages and set custom column values.

6

Analytics

Ask for sends, reply rates, and campaign performance and get numbers back.

Connect in three steps

  1. 1

    Create an API key

    In GramClaw → Settings → API Keys, generate a key with the scopes you want (read / send).

  2. 2

    Add the MCP server

    Paste https://gramclaw.com/api/mcp?key=gc_live_… into Claude Desktop, Cursor, or any MCP client.

  3. 3

    Talk to your agent

    Ask it to search, message, broadcast, or launch a campaign — it calls the tools for you.

Telegram MCP FAQ

What is a Telegram MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. The GramClaw Telegram MCP server exposes your Telegram outreach — searching chats, sending messages, running broadcasts, and creating campaigns — as MCP tools, so an AI agent like Claude can operate Telegram for you in plain language.
How do I connect the Telegram MCP to Claude?
Create an API key in Settings, then add the MCP server URL https://gramclaw.com/api/mcp?key=gc_live_… to your MCP client (Claude Desktop, Cursor, or any MCP-compatible app). The key both identifies you and authorizes the tools, scoped to the accounts that key can act on.
Which Telegram actions can the AI perform?
The server exposes tools to identify the workspace, search messages, list and read chats, list contacts, start a chat, send a message, run a broadcast, create and check campaigns, move pipeline stages, set columns, and pull analytics.
Is it safe to give an AI agent access?
The MCP key is scoped and only acts on the accounts it's allowed to. Access requires an active subscription or trial, and you can revoke a key at any time from Settings. Treat the key like a password.
Do I need to write code to use it?
No. Connecting the MCP server is a paste-the-URL step in your AI client. Developers who prefer raw HTTP can use the REST API instead — both hit the same Telegram outreach engine.

Related

Telegram + Claude integration

Step-by-step: connect GramClaw to Claude.

Telegram AI agent

Build an autonomous agent that works Telegram.

API documentation

The REST endpoints behind the same engine.

Telegram Outreach

The full outreach automation platform.

Put your Telegram outreach on rails

Connect a Telegram account and launch your first campaign in minutes. Every plan starts with a 7-day free trial, so you can evaluate the whole platform before you pay.

Start 7-Day Free Trial
Chat on Telegram