> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpressbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Tools

> Read Telegram campaigns, their results, and the groups your bot is in.

## What is this?

Read-only tools for your Telegram bot.

These tools belong to the [Workspace MCP](https://docs.xpressbot.org/api-reference/mcp/workspace/overview.md). Each tool below shows its **Mode** (**Read** runs immediately; **Write** asks your MCP client to confirm first) and the **Permission needed** for it to appear for your key — "None" means every connected key sees it.

## What can I do here?

* Review Telegram campaigns and their results
* See which groups the bot is in and their moderation status

## Tools

### `list_telegram_campaigns`

Telegram campaigns (broadcasts) of the user's current channel, newest first: status, schedule and results (recipients, sent, failed, blocked the bot).

**Mode:** Read · **Permission needed:** `telegram:view`

### `get_telegram_campaign`

One Telegram campaign (from list\_telegram\_campaigns): audience, schedule, results, recipients by status and the latest delivery errors.

**Mode:** Read · **Permission needed:** `telegram:view`

### `list_telegram_groups`

Telegram groups the channel's bot is in: title, type, the bot's role (member or admin), member count, how many members have moderation warnings, and when it was last synced.

**Mode:** Read · **Permission needed:** `telegram:view`

## Troubleshooting / Technical Notes

* **A tool I expect isn't offered.** The MCP server only offers tools whose required permission your API key's owner holds, re-checked on every call. Grant the permission shown on the tool — see [Team](https://docs.xpressbot.org/workspace/team.md).
* **A Write tool never seems to run.** Your MCP client asks you to approve every Write tool call. Check for a pending approval prompt.
* **A call returns an error.** See [MCP errors](https://docs.xpressbot.org/api-reference/mcp/errors.md).

## Related docs

* [Workspace MCP tool catalog](https://docs.xpressbot.org/api-reference/mcp/workspace/tools/overview.md)
* [Workspace MCP](https://docs.xpressbot.org/api-reference/mcp/workspace/overview.md)
* [Telegram overview](https://docs.xpressbot.org/workspace/telegram/overview.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.