tgatlas-mcp
This server gives an AI agent read-only access to public Telegram channel metadata via three tools.
telegram_channel: Look up a public channel's profile — title, description, exact subscriber count, creation date, verification/scam flags, last post date, and posting cadence — to verify it is real, gauge its size, and check whether it is still active.
telegram_similar_channels: Get the channels Telegram itself recommends as similar to a given channel, enabling audience-based discovery by walking outward from known seeds; optionally enrich results with exact subscriber counts.
telegram_search_channels: Search Telegram's global index of public channels and groups by keyword to find starting points for further exploration.
Output is Markdown by default for easy model reading, or raw JSON for programmatic use.
Scope is limited to public channel metadata; message contents, member lists, and private groups are not accessible.
Provides access to public Telegram channel metadata, including profiles, subscriber counts, creation dates, verification and scam flags, posting cadence, similar channel recommendations, and global channel search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tgatlas-mcp Check @cryptonews for scam flags and recent posting frequency"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tgatlas-mcp
MCP server for public Telegram channels. Gives an agent a channel's real profile — subscribers, description, creation date, verification and scam flags, how often it posts — and the channels Telegram itself considers similar to it.
No phone number, no session file, no MTProto client to keep alive. An API key and a Node runtime.
Install
npx tgatlas-mcpClaude Desktop / Claude Code / any MCP client:
{
"mcpServers": {
"tgatlas": {
"command": "npx",
"args": ["-y", "tgatlas-mcp"],
"env": { "TELEGRAM_API_KEY": "your-rapidapi-key" }
}
}
}Get a key at rapidapi.com/starnikovoleg/api/telegram155. There is a free tier and no card.
Related MCP server: TG Analytics MCP
Tools
telegram_channel
A channel's profile: title, description, exact subscriber count, creation date, Telegram's own verification and scam flags, and posting cadence.
The cadence is the part most directories leave out, and it is usually the answer to the question being asked. A channel with 200,000 subscribers and nothing published in fourteen months looks identical to a live one in every listing that reports only follower counts.
@durov — Du rov's Channel
Subscribers 1,400,000
Created 2017-02-15
Last post 2026-08-29
Posting rate 0.4 posts/day over the last 30telegram_similar_channels
The channels Telegram recommends alongside a given one — its own topical judgement rather than a keyword match, so it returns channels that share an audience without sharing vocabulary.
This is how you find channels whose names you do not already know: start from one you do and walk outward. Two rounds of expansion from a few dozen seeds reaches several thousand channels.
Set enrich: true to fetch exact subscriber counts for each result.
telegram_search_channels
Telegram's global search over public channels and groups. Use it to find a
starting point; use telegram_similar_channels to expand it.
Output
Markdown by default — what a model reads without a parsing step. Pass
format: "json" for the raw API response when you are piping into code.
Scope
Public channel metadata only. Message contents, member lists, and private groups are outside what this reads and outside what it will return.
Cost
Tools call the REST endpoints directly rather than proxying a remote MCP
endpoint. RapidAPI bills per request, so this arrangement means initialize
and tools/list are free: you pay for lookups, not handshakes.
telegram_channel costs three calls with cadence on, two with
cadence: false. telegram_similar_channels costs two, plus one per result
when enrich: true (capped at 12).
Environment
Variable | Default | Purpose |
| — | RapidAPI key. |
|
| Upstream host. |
|
| Per-request timeout. |
Related
TgAtlas publishes a weekly measured corpus built on the same API: channel directories by topic, the recommendation graph inverted into "who recommends this channel", and how those numbers move week to week.
MIT.
Available Tools
3 toolstelegram_channelTelegram channel profileARead-only
Look up a public Telegram channel: title, description, exact subscriber count, creation date, verification and scam flags, and how often it posts. Use to check whether a channel is real, how large it is, and whether it is still alive — a channel with 200k subscribers and nothing published this year is a common and invisible failure.
Inputs: channel (required), format, cadence.
telegram_search_channelsSearch public Telegram channelsARead-only
Telegram's own global search over public channels and groups, by title and handle. Good for seeding a topic; telegram_similar_channels is what expands a seed into a neighbourhood. Short topical words work better than sentences.
Inputs: query (required), format.
telegram_similar_channelsChannels Telegram considers similarARead-only
Return the channels Telegram itself recommends alongside a given channel — its own topical judgement, not a keyword match, so it surfaces channels that share an audience without sharing vocabulary. The way to discover channels whose names you do not already know: start from one you do and walk outward. Large channels return roughly a dozen; small or very new ones return none.
Inputs: channel (required), enrich, format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a clearly distinct action: fetching a single channel's details, discovering similar channels via recommendations, and searching Telegram's global index by keyword. There is no functional overlap between the tools, and the descriptions reinforce the differences.
All tool names share the telegram_ prefix, but the suffixes mix a noun (channel), an adjective-noun pair (similar_channels), and a verb-noun pair (search_channels). This is still readable and predictable, with only a minor deviation in grammatical pattern.
Three tools is a well-scoped count for a focused read-only Telegram channel index server. Each tool provides a distinct core capability without redundancy or bloat.
For a read-only directory, the toolset covers the full workflow: search to find a starting channel, retrieve detailed metadata, and expand outward via similar channels. No obvious lifecycle gaps exist because create/update/delete are not relevant to this domain.
Maintenance
Related MCP Connectors
Live Telegram data: trending topics, channel profiles & metrics, post history incl. edits/deletions.
Search millions of Telegram channels: metrics, growth, ads, posts and row-priced exports.
Search 1.7M+ Telegram channels, 250k+ chats, 228k+ bots, and what chats ask for. No key, no install.
Extract public Telegram channel messages, media metadata, crypto addresses, and RAG Markdown.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables Claude to interact with Telegram channels and groups through API or web scraping for reading posts and searching.15MIT
- FlicenseNot gradedqualityDmaintenanceEnables LLM agents to analyze Telegram channels for ad purchasing, providing insights like reach, CPM, and verdicts via MCP tools.-
- AlicenseNot gradedqualityDmaintenanceReads public Telegram channel pages and exposes them as MCP tools over Streamable HTTP/JSON-RPC, enabling retrieval of channel info, latest posts, and search without Telegram API credentials.1MIT
- AlicenseNot gradedqualityCmaintenanceRead public Telegram channels from AI agents — channel metadata, posts, comments, and search. No MTProto, no Telethon, no api_id.1MIT