GramClaw

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.

Example: one request in Claude, one approved campaign

1. 1

   You ask

   “Send our launch note to everyone I talked to about the beta last week, from my main account. Follow up after 3 days if they don't answer.”
2. 2

   Claude does the legwork

   Claude searches your messages, collects the matching chats, writes the message and the follow-up, then calls gramclaw_create_campaign.
3. 3

   You approve

   Nothing is sent yet. An approval request appears in GramClaw with the exact text and recipients. One click approves it; anything you don't approve never runs.
4. 4

   GramClaw sends it safely

   The campaign runs like any other: 2–5 minutes between messages, daily limits per account, and follow-ups that stop on reply. Ask Claude “how is the launch campaign doing?” and it reads the results.

Every tool the server exposes

Read tools run straight away. Tools that change something create an approval request first.

Tool	What it does	Approval
gramclaw_whoami	Shows your workspace and the Telegram accounts the key can use.	Not needed
gramclaw_list_chats	Lists the chats of one account, with an optional title filter.	Not needed
gramclaw_get_chat	Reads a chat's details and participants.	Not needed
gramclaw_get_messages	Reads conversation history without marking it as read.	Not needed
gramclaw_search_messages	Searches your saved Telegram messages.	Not needed
gramclaw_list_contacts	Lists known contacts per account.	Not needed
gramclaw_list_campaigns	Lists campaigns with sent, replied and failed counts.	Not needed
gramclaw_get_campaign	Shows one campaign's steps and progress per recipient.	Not needed
gramclaw_start_chat	Opens a private chat with a @username. Sends nothing.	Not needed
gramclaw_send_message	Sends one message to an existing chat.	One click in GramClaw
gramclaw_move_pipeline_stage	Moves a chat to a pipeline stage.	One click in GramClaw
gramclaw_set_column	Sets or clears a CRM column value.	One click in GramClaw
gramclaw_create_campaign	Creates a campaign or broadcast to up to 100 chats, with up to 5 follow-ups.	One click in GramClaw

What the AI can and can't do

• Scoped keys: a key only gets the scopes you choose (read, send, write, campaign) and only the accounts it is allowed to use.
• Every change waits for you: sends, pipeline moves, column changes and campaigns all need one click in GramClaw.
• Message content is passed to the AI marked as untrusted data, which helps it ignore instructions hidden inside Telegram messages.
• Some actions aren't available over MCP at all: attachments, forwarding, reactions, editing and deleting.
• Revoke a key in Settings → API Keys at any time and access stops immediately.

MCP or REST API?

Both reach the same GramClaw engine and the same sending limits. The difference is who is in control. With MCP, an AI assistant like Claude picks which tool to call from a sentence you type, which suits one-off tasks, research and reviews. With the REST API, your own code calls fixed endpoints, which suits scheduled jobs, syncing with another system, or anything that must run the same way every time.

Read the full comparison: MCP vs API →

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.

What's the difference between MCP and an API?

An API is a set of endpoints that your code calls in a fixed way. MCP (Model Context Protocol) is a standard that describes tools so an AI assistant can find them and decide when to use them. GramClaw offers both: the MCP server for Claude and other assistants, and the REST API for your own scripts.

Does Claude need my approval to send messages?

Yes. Every send, pipeline move, column change or campaign made through MCP creates an approval request in GramClaw. Nothing runs until you click Approve.

Put your Telegram outreach on rails

Connect a Telegram account and launch your first campaign in minutes. Start a 7-day trial through checkout with a payment method, and evaluate the platform before your first subscription charge.