# Connect Cursor to Telegram

Source: https://postgale.com/guides/cursor/telegram

Yes, Cursor can post to Telegram through Postgale. Add https://postgale.com/mcp to Cursor’s mcp.json and sign in to Postgale when Cursor asks (or use an API key header), connect your Telegram account in Postgale once, and Cursor can channel and group posts, photos, videos, albums, edits and deletes. A person can be required to approve every post, reply and message before it goes out.

## Can Cursor post to Telegram?

Postgale is the secure layer for AI agents on social media. MCP (Model Context Protocol) is the open standard that lets AI assistants such as Claude and Cursor use outside tools. An MCP server is what they connect to. Cursor does not reach Telegram on its own; with Postgale connected it gets tools for the Telegram accounts you connected and nothing else.

| Task | What Postgale does |
| --- | --- |
| Publish | Text up to 4096 characters, one photo, video or document, or an album of 2 to 10 items with a caption; MarkdownV2 or HTML formatting; silent delivery; scheduling. |
| Edit | Change the text of a message or the caption of a media post or album. |
| Delete | Remove a message, or every message of an album. |
| Metrics | The chat’s member count as an account metric. Telegram gives bots no per-post views. |

## What do you need?

- A Telegram channel or group where you are an admin who can add other admins.
- A Postgale workspace, and a sign-in or an API key for the agent.
- Optional media on a public HTTPS URL (upload it with `upload_media`): photos up to 10 MB, videos and documents up to 50 MB.
- Cursor, set up as below (Cursor’s agent with MCP).

## Step 1: connect your Telegram channel or group

1. Create a Postgale workspace and open Dashboard → Accounts → Telegram. You get a one-time code that is valid for 15 minutes.
2. In Telegram, add Postgale’s bot to your channel or group as an admin with the right to post messages.
3. Post `/connect` followed by the code in the chat. The channel or group appears in Postgale within seconds.
4. Connect your AI tool: add `https://postgale.com/mcp` in [ChatGPT](https://postgale.com/guides/chatgpt), [Claude](https://postgale.com/guides/claude) or [Cursor](https://postgale.com/guides/cursor) and sign in to Postgale, or create a key under Dashboard → API keys for [n8n](https://postgale.com/guides/n8n) or your own code.

An agent can also start the connection itself: the `connect_account` tool (or `POST /api/v1/connect/telegram`) returns the code and the steps for the person who runs the chat. The agent never gets a token.

## Step 2: connect Cursor to Postgale

1. Create a Postgale workspace and connect the social accounts the agent may use under Dashboard → Accounts.
2. In Cursor, open Settings → MCP and add a server, or edit `.cursor/mcp.json` in the project (or `~/.cursor/mcp.json` for every project). The URL alone is enough:

.cursor/mcp.json:
```json
{
  "mcpServers": {
    "postgale": {
      "url": "https://postgale.com/mcp"
    }
  }
}
```

1. Cursor shows a sign-in prompt for the server. A Postgale page opens in the browser: sign in, pick the workspace the app may use and approve. The consent page names the app and where it returns to; approve only requests you started yourself.
2. Cursor lists the Postgale tools under the server once it connects; enable them for the agent.
3. In the agent chat, ask: “Which social accounts are connected in Postgale?” to check the connection.

## Can I use an API key instead?

Yes, for shared or automated setups where nobody should sign in personally. In Postgale, open Dashboard → API keys, create a key and copy it (it starts with `sk_` and is shown once). Connect the social accounts the agent may use under Dashboard → Accounts. Then add a headers block:

.cursor/mcp.json (API key):
```json
{
  "mcpServers": {
    "postgale": {
      "url": "https://postgale.com/mcp",
      "headers": {
        "Authorization": "Bearer sk_…"
      }
    }
  }
}
```

> Keep the key out of version control: use the global file, or an environment variable if your Cursor version supports `${env:…}` in mcp.json.

## What can I ask Cursor to do on Telegram?

Check the connection first: “Which Telegram accounts are connected in Postgale?” Then, in plain language:

> Ask your agent: “Post this week’s changelog to our Telegram channel with the two screenshots as an album, silently.”

> Ask your agent: “Schedule a Telegram post for Friday at 5pm with the opening hours in bold (HTML formatting).”

> Ask your agent: “Fix the typo in the caption of this morning’s Telegram post.”

POST /api/v1/posts (Telegram):
```json
{
  "content": "<b>This week</b>: faster sync, dark mode and 12 fixes.",
  "platforms": [
    {
      "accountId": "acc_tg",
      "platformSpecificData": {
        "mediaUrls": [
          "https://media.example.com/sync.png",
          "https://media.example.com/dark.png"
        ],
        "parseMode": "HTML",
        "disableNotification": true
      }
    }
  ],
  "scheduledFor": "2026-11-06T17:00:00Z"
}
```

## Which Telegram rules does Postgale enforce?

- Text is limited to 4096 characters and captions to 1024, counted after formatting markup; a longer post is refused before it reaches Telegram.
- Albums have 2 to 10 items, and documents cannot share an album with photos or videos.
- Files are uploaded by Postgale within Telegram’s bot limits: 10 MB per photo, 50 MB per video or document.
- When Telegram asks to slow down, Postgale waits the time Telegram gives before retrying.
- If the bot is removed or loses the right to post, the account is marked as needing reconnection and your webhook hears about it.

## How do I keep a person in the loop?

- Approval: tick “Hold posts from this app for approval” when you sign in, or in the Postgale dashboard require approval for the API key the agent uses (or for the whole workspace, or one account). Posts then wait as pending approval; comment replies and moderation, direct messages, WhatsApp sends and edits to live posts wait in the same queue. A person approves, edits or rejects each one in Dashboard → Approvals; the agent’s own key or sign-in cannot approve.
- Tool annotations: every Postgale tool declares whether it only reads, writes, or publishes or sends live, deletes or spends. Clients that honour annotations ask before destructive tools run.
- Audit log: every write the agent makes is recorded with the key or the connected app, the action and the time.
- Revoking: each sign-in appears under Dashboard → Connected apps and each key under Dashboard → API keys; either can be revoked at any time.

## What can’t an agent do on Telegram through Postgale?

- Post to personal chats or to chats where the bot is not an admin.
- Read views or reactions per post. The Bot API does not give them to bots.
- Delete messages older than 48 hours. Telegram does not allow it.

## Questions

### Can Cursor post to Telegram?

Yes, Cursor can post to Telegram through Postgale. Add https://postgale.com/mcp to Cursor’s mcp.json and sign in to Postgale when Cursor asks (or use an API key header), connect your Telegram account in Postgale once, and Cursor can channel and group posts, photos, videos, albums, edits and deletes. A person can be required to approve every post, reply and message before it goes out.

### Does Cursor see my Telegram password or tokens?

No. A chat admin makes Postgale’s bot an admin of the channel or group and posts a one-time code there; there is no Telegram password or bot token involved. Cursor only holds a Postgale API key or sign-in, which you can revoke at any time.

### Can I approve what Cursor sends to Telegram before it goes live?

Yes. Turn on approval for the API key it uses, the account or the whole workspace. Posts, replies and messages then wait in the Postgale dashboard until a person approves, edits or rejects them; Cursor’s own access cannot approve.

### Can Cursor schedule Telegram posts?

Yes. Ask for a date and time; Postgale stores the post as scheduled and publishes it then, and reports the result (post.published or post.failed) on your webhook and in get_post.

## Related

- [Cursor guide](https://postgale.com/guides/cursor)
- [Telegram for AI agents](https://postgale.com/integrations/telegram)
- [Cursor and Instagram](https://postgale.com/guides/cursor/instagram)
- [Cursor and Facebook](https://postgale.com/guides/cursor/facebook)