# Telegram data for AI agents

> ToolSocket gives Claude, ChatGPT, Cursor, Codex and any MCP or REST client live access to Telegram — public channels and messages — through 7 ready-made tools. No Telegram account, scraper or API key of your own is needed: connect https://toolsocket.top/mcp once and pay per call (most calls $0.0015).

ToolSocket 让 Claude、ChatGPT、Cursor、Codex 等任何支持 MCP 或 REST 的 AI 智能体，直接读取Telegram的实时数据：公开频道和消息数据，共 7 个工具。不用注册Telegram账号、不用写爬虫，接入一个地址即可，按次计费（大多 $0.0015/次）。

## Connect

- MCP (Claude.ai, ChatGPT, Claude Code, Cursor, VS Code, Codex): `https://toolsocket.top/mcp` — OAuth sign-in or `Authorization: Bearer ts_live_…`
- Claude Code: `claude mcp add --transport http toolsocket https://toolsocket.top/mcp`
- Any agent that reads skills: `set up https://toolsocket.top/SKILL.md`
- Setup for every client: https://toolsocket.top/docs.md

## Example

Ask your agent: "What did this Telegram channel post today?" / 「这个 Telegram 频道今天发了什么？」

```bash
curl -s -X POST https://toolsocket.top/v1/run -H "Authorization: Bearer $TOOLSOCKET_API_KEY" \
  -H "content-type: application/json" -d '{"tool":"telegram#web/fetch_channel_search","input":{"channel":"durov","query":"TON","limit":20},"wait":30}'
```

## Tools (7)

| Tool | ID | Price | What it does |
|---|---|---|---|
| Telegram · Get channel info (web) · Telegram · 获取频道信息（web） | `telegram#web/fetch_channel_info` | $0.0015 / call | Get public Telegram channel metadata: title, description, avatar, subscriber count, verified badge and media counters. |
| Telegram · Batch channel info (web) · Telegram · 批量频道信息（web） | `telegram#web/batch_channel_info` | $0.012 / call | Fetch basic info (title/description/avatar/subscribers/verified) for multiple public channels concurrently. |
| Telegram · Similar channels (web) · Telegram · 相似频道推荐（web） | `telegram#web/fetch_similar_channels` | $0.0015 / call | Get Telegram's official "similar channels" recommendations (for channel discovery). |
| Telegram · Get channel posts (paginated) (web) · Telegram · 获取频道消息(分页)（web） | `telegram#web/fetch_channel_posts` | $0.0015 / call | Fetch a public channel's recent posts (text, photos, videos, forwards, replies, link previews, reactions, views, time). |
| Telegram · Get single post (web) · Telegram · 获取单条消息（web） | `telegram#web/fetch_post_detail` | $0.0015 / call | Get a single public-channel post (parsed from the t.me embed view). |
| Telegram · Post comments (web) · Telegram · 帖子评论/讨论（web） | `telegram#web/fetch_post_comments` | $0.0015 / call | Fetch comments of a channel post from its **linked discussion group**. |
| Telegram · Search posts in a channel (web) · Telegram · 频道内关键词搜索（web） | `telegram#web/fetch_channel_search` | $0.0015 / call | Search posts in a channel by keyword (case-insensitive). |
