MCP Communicator (Telegram): Two-Way Chats & Instant Feedback

What is MCP Communicator (Telegram): Two-Way Chats & Instant Feedback?

MCP Communicator (Telegram) is a server solution enabling bidirectional communication between applications and users via Telegram. It allows systems to send questions to designated users and receive real-time responses through a dedicated bot. This toolstreamlines interaction by handling asynchronous messaging, validation, and security protocols.

How to Use MCP Communicator (Telegram): Two-Way Chats & Instant Feedback?

Implementation follows three core steps: setup, configuration, and integration.

1. Setup: Install via npm globally or use npx for on-demand access. Retrieve your Telegram chat ID using the provided utility.
2. Configuration: Define environment variables for bot token and chat ID in a .env file. Register the server in your MCP settings with the specified path and credentials.
3. Integration: Use the ask_user tool to prompt users, passing a question object. Responses are returned once the user replies to the bot.

Key Features of MCP Communicator (Telegram): Two-Way Chats & Instant Feedback?

• Secure authentication through validated chat IDs and environment variables
• Asynchronous response handling with indefinite wait times
• Message tracking using reply-based message IDs
• Comprehensive error logging and context-aware message filtering
• Lightweight dependency structure for flexible deployment

Use Cases of MCP Communicator (Telegram): Two-Way Chats & Instant Feedback?

Common applications include:

• User consent workflows requiring instant verification
• Automated system status updates with interactive prompts
• Development environments needing real-time debugging input
• Multi-step user surveys integrated into backend processes

FAQ from MCP Communicator (Telegram): Two-Way Chats & Instant Feedback?

• How do I retrieve my chat ID? Use the npx mcptelegram-chatid utility after sending a test message to your bot.
• What happens if a user sends an invalid response? The system waits indefinitely until a valid reply is received, maintaining message context.
• Can multiple users be configured? Currently supports single chat ID for security, but future versions may allow list-based access control.
• How are security threats mitigated? All communication is encapsulated within Telegram's infrastructure, with server-side validation of message origins.

MCP Communicator (Telegram)

An MCP server that enables communication with users through Telegram. This server provides a tool to ask questions to users and receive their responses via a Telegram bot.

Installation

Via npm (global)

npm install -g mcp-communicator-telegram

Via npx (on-demand)

npx mcptelegram

To get your Telegram chat ID:

npx mcptelegram-chatid

Features

• Ask questions to users through Telegram
• Receive responses asynchronously (waits indefinitely for response)
• Support for reply-based message tracking
• Secure chat ID validation
• Error handling and logging

Prerequisites

• Node.js (v14 or higher)
• A Telegram bot token (obtained from @BotFather)
• Your Telegram chat ID (can be obtained using the included utility)

Installation

1. Clone the repository:

git clone https://github.com/qpd-v/mcp-communicator-telegram.git
cd mcp-communicator-telegram

2. Install dependencies:

npm install

3. Create a Telegram bot:

* Open Telegram and search for [@BotFather](https://t.me/botfather)
* Send `/newbot` and follow the instructions
* Save the bot token you receive

4. Get your chat ID:

* Copy `.env.example` to `.env`
* Add your bot token to the `.env` file:
    
            TELEGRAM_TOKEN=your_bot_token_here
    

* Run the chat ID utility:
    
            npm run build
    node build/get-chat-id.js
    

* Send any message to your bot
* Copy the chat ID that appears in the console
* Add the chat ID to your `.env` file:
    
            TELEGRAM_TOKEN=your_bot_token_here
    CHAT_ID=your_chat_id_here
    

Configuration

Add the server to your MCP settings file (usually located at %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json on Windows):

{
  "mcpServers": {
    "mcp-communicator-telegram": {
      "command": "node",
      "args": ["path/to/mcp-communicator-telegram/build/index.js"],
      "env": {
        "TELEGRAM_TOKEN": "your_bot_token_here",
        "CHAT_ID": "your_chat_id_here"
      }
    }
  }
}

Available Tools

ask_user

Asks a question to the user via Telegram and waits for their response.

Input Schema:

{
  "type": "object",
  "properties": {
    "question": {
      "type": "string",
      "description": "The question to ask the user"
    }
  },
  "required": ["question"]
}

Example usage:

const response = await use_mcp_tool({
  server_name: "mcp-communicator-telegram",
  tool_name: "ask_user",
  arguments: {
    question: "What is your favorite color?"
  }
});

Development

Build the project:

npm run build

Run in development mode:

npm run dev

Watch for changes:

npm run watch

Clean build directory:

npm run clean

Security

• The server only responds to messages from the configured chat ID
• Environment variables are used for sensitive configuration
• Message IDs are used to track question/answer pairs
• The bot ignores messages without proper context

License

ISC

Author

qpd-v

Version

0.1.2