MCP Telegram

Package: @iqai/mcp-telegram Purpose: Interacting with Telegram bots and channels using the Telegraf library.

Features

• Provides tools to send messages, get channel information, forward messages, pin messages, and get channel members.
• Uses the Telegraf library, a modern and feature-rich Telegram bot framework for Node.js.

Available Tools

The server exposes the following tools that MCP clients can utilize:

SEND_MESSAGE

Send a message to a Telegram chat or channel.

• Parameters: chatId (string), text (string), parseMode (string, optional), disableWebPagePreview (boolean, optional), disableNotification (boolean, optional)

GET_CHANNEL_INFO

Get information about a channel or chat.

• Parameters: channelId (string)

FORWARD_MESSAGE

Forward a message from one chat to another.

• Parameters: fromChatId (string), toChatId (string), messageId (string), disableNotification (boolean, optional)

PIN_MESSAGE

Pin a message in a chat or channel.

• Parameters: chatId (string), messageId (string), disableNotification (boolean, optional)

GET_CHANNEL_MEMBERS

Get channel administrators (limited by Telegram API).

• Parameters: channelId (string), limit (number, optional)

Environment Variables

• TELEGRAM_BOT_TOKEN: Your Telegram bot token (required)

Configuration Example

{
  "mcpServers": {
    "telegram-mcp-server": {
      "command": "pnpm",
      "args": ["dlx", "@iqai/mcp-telegram"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "your_bot_token_here"
      }
    }
  }
}

Usage Examples

SEND_MESSAGE

Send a message to a Telegram channel:

{
  "tool_name": "SEND_MESSAGE",
  "arguments": {
    "chatId": "@mychannel",
    "text": "Hello from the Telegram MCP Server!"
  }
}

GET_CHANNEL_INFO

Get information about a Telegram channel:

{
  "tool_name": "GET_CHANNEL_INFO",
  "arguments": {
    "channelId": "@mychannel"
  }
}

Response Examples

SEND_MESSAGE

Successful response:

{
  "success": true,
  "result": "Message sent successfully!\n\nMessage ID: 123\nChat ID: @mychannel\nSent at: 2024-03-15T12:34:56.789Z\nText: Hello from the Telegram MCP Server!"
}

GET_CHANNEL_INFO

Successful response:

{
  "success": true,
  "result": "Channel Information:\n\nTitle: My Channel\nID: -1001234567890\nType: channel\nUsername: mychannel\nDescription: This is my Telegram channel.\nMember Count: 1234"
}

Error Handling

The tools will return an error message in the result field if an error occurs. Common errors include:

• Missing bot token: Ensure the TELEGRAM_BOT_TOKEN environment variable is set.
• Invalid chat ID: Double-check the chat ID or username.
• Bot not in channel: Add the bot to the channel with appropriate permissions.

Bot Setup

1. Create a bot with @BotFather
2. Get your bot token
3. Add your bot to channels with appropriate permissions
4. Use channel usernames (e.g., @mychannel) or chat IDs for interactions