Advertise
MCP.so
Sign In

MCP Integration example with Telegram

@arananet

Repository

Basic information

Category

Communication

License

MIT license

Transports

stdio

Author

arananet

About MCP Integration example with Telegram

A Python-based Model Context Protocol (MCP) client and server that enables LLMs to send notifications via Telegram and receive user responses.

MCP Integration example with Telegram config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-telegram-poc": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv"
      ]
    }
  }
}

MCP Integration example with Telegram tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Integration example with Telegram?

A Python-based Model Context Protocol (MCP) client and server that enables LLMs to send notifications via Telegram and receive user responses. It decouples the LLM’s reasoning from the execution of external actions, making tool integration more modular and maintainable.

How to use MCP Integration example with Telegram?

Clone the repository, install dependencies (pip install -r requirements.txt), create a virtual environment, and fill in your Telegram credentials in a .env file (Telegram bot token, chat ID, OpenAI API key). Run the server with python3 src/mcp_handler.py, or test client interaction with python3 examples/test_client.py. The server exposes two tools: send_alert (sends a Telegram message) and check_reply (polls for replies).

Key features of MCP Integration example with Telegram

  • Send text alerts to Telegram with customizable urgency levels
  • Check for user replies with configurable timeouts
  • Integration with MCP‑compatible LLM applications
  • Decouples reasoning from execution for safer tool use
  • Update external tools without changing LLM prompts
  • Supports AutoGen 0.4 framework integration

Use cases of MCP Integration example with Telegram

  • Notify a user of critical events and wait for confirmation
  • Enable an LLM to send alerts and process human feedback
  • Prototype MCP‑based tool integrations with messaging platforms
  • Demonstrate modular architecture for LLM‑driven workflows

Frequently asked questions

1

How does MCP differ from function calls or agent tools?

MCP separates the LLM’s decision‑making from execution; you can swap out tools without modifying the LLM. Direct function calls or agent methods mix logic, making maintenance harder.

2

What are the prerequisites?

Python 3.11+, a Telegram bot token (from @BotFather), your Telegram chat ID, and an OpenAI API key.

3

How do I get a Telegram bot token and find my chat ID?

Chat with @BotFather on Telegram, send `/newbot`, and follow the prompts. To find your chat ID, send a message to your bot, then visit `https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates` and look for the `chat` object’s `id` field.

4

What runtime environment is needed?

The server runs as a standalone Python script. Use a virtual environment and install dependencies from `requirements.txt`. It is tested on Linux/macOS.

5

Are there known limits?

The README does not specify limits beyond the configurable `timeout_seconds` for `check_reply` (default 60 seconds). The server uses polling for replies.

Comments

More Communication MCP servers

Faxify MCP

Const Agility, LLC

Send, receive and track real faxes in the US and Canada from Claude, ChatGPT or Cursor.

SomaCheck Vibecheck

Sensie-agents

Body language for AI agents, on your terms. A consented three-second phone gesture gives your agent an Aligned or Unaligned signal with confidence. You remain the authority.

1

Mobile Text Alerts SMS

Mobile Text Alerts

Official Mobile Text Alerts server. Send and schedule SMS, manage subscribers and groups, and complete carrier registration from any MCP-compatible AI assistant.

LinkedIn MCP Server: DMs, Inbox & Network for Claude, ChatGPT, Cursor

TalkToHumans

LinkedIn MCP server for Claude, ChatGPT, Cursor & Codex. Read LinkedIn DMs, search your network, enrich profiles and draft messages you review before sending.

gtm-api

gtm-api

MCP server and API for AI agents that work LinkedIn on accounts you own: search, connect, message and enrich, with limits enforced on our server.

Advertise