Metadata-Version: 2.4
Name: telegram-mcp
Version: 0.2.0
Summary: MCP server for Telegram - lets AI agents communicate with users via Telegram
Author-email: Furkan Kucuk <furkankucuk.dev@gmail.com>
License-Expression: MIT
Keywords: agent,ai,bot,mcp,telegram
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.8.0
Description-Content-Type: text/markdown

# Telegram MCP

MCP server that lets AI agents communicate with users via Telegram.

## Installation

```bash
pip install telegram-mcp
```

## Configuration

Add to your MCP client config:

```json
{
  "telegram": {
    "command": "telegram-mcp",
    "env": {
      "TELEGRAM_BOT_TOKEN": "your-bot-token",
      "TELEGRAM_CHAT_ID": "your-chat-id"
    }
  }
}
```

## Get Your Credentials

1. Create a bot via [@BotFather](https://t.me/BotFather) → copy the token
2. Message your bot, then get your chat ID from [@userinfobot](https://t.me/userinfobot)

## Tools

### `interact`

Send a message to the user via Telegram.

```python
# Status update
interact(message="Working on it...")

# Ask a question (blocks until user replies)
result = interact(message="What's next?", wait_for_reply=True)

# Yes/No with buttons
result = interact(message="Delete?", choices=["Yes", "No"], wait_for_reply=True)
```

### `get_messages`

Get recent conversation history.

```python
result = get_messages(limit=10)
```

## License

MIT
