Metadata-Version: 2.4
Name: xbghc-telegram-mcp
Version: 0.1.0
Summary: Telegram MCP server for Claude Code — provides wait_for_message and send_message tools
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.10
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# telegram-mcp

Telegram MCP server for Claude Code.

## Tools

- **wait_for_message** — Blocks until a new Telegram message arrives (long polling internally)
- **send_message** — Send a message to a Telegram chat

## Usage

```bash
uvx xbghc-telegram-mcp
```

### Claude Code `.mcp.json`

```json
{
  "mcpServers": {
    "telegram": {
      "command": "uvx",
      "args": ["xbghc-telegram-mcp"],
      "env": {
        "TELEGRAM_BOT_TOKEN": "${TELEGRAM_BOT_TOKEN}"
      }
    }
  }
}
```

### Environment Variables

- `TELEGRAM_BOT_TOKEN` (required) — Bot token from [@BotFather](https://t.me/BotFather)
- `http_proxy` / `https_proxy` (optional) — Auto-detected for proxy support
