TGStat MCP
tgstat-mcp
TGStat MCP server: Telegram channel and post search, subscriber and reach trends, ERR and mentions
Install
claude mcp add tgstat -e TGSTAT_TOKEN=ваш_токен -- npx -y @theyahia/tgstat-mcpThis is third-party code. Review the repository files before installing.
What it does
The server gives the agent access to the TGStat API. The agent searches channels by topic, language and country, fetches a channel profile with the RKN registration mark, average reach and ERR, and subscriber and view history by hour, day or week. It can compare several channels in one table, find who reposts and mentions a channel, and chart mentions of a word or phrase over time. Responses are trimmed to relevant fields to save context, and dates in filters use a plain format.
Who it is for. For marketers and SMM specialists who buy Telegram ads or track brand mentions.
Good fit when
- You need to compare channels by reach and ERR before buying ads
- You need to track where a brand or channel is mentioned
- You need a channel's subscriber growth over a quarter
Not a fit when
- You have no paid TGStat API access
- You need to post or manage a channel: the server is read-only
Example request
Compare three news channels by reach and ERR over the last monthLimitations
Requires a TGStat API token. Different tools need different packages, Stat API or Search API, and get_usage shows quota and expiry. Data is limited to what TGStat indexes. Community project, not a TGStat product.
How to disable. Run claude mcp remove tgstat or delete the tgstat block from your MCP client config.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| TGSTAT_TOKEN required, secret | TGStat API token with Stat API and/or Search API access |
Security check
- Requires a paid TGStat API token
- Requests consume the package quota
README in short
The README explains where to get a TGStat token and gives npx configs for Claude Desktop and Claude Code. Tools are grouped into channels, posts, time-series metrics, keywords, reference lists and quota usage. It describes the trimmed response format with ISO dates and lists example prompts. Part of the author's WWmcp series, MIT license.
FAQ
Where do I get a token?
On api.tgstat.ru after signing up. Statistics and search need different API packages.
Can I search posts by keywords?
Yes, there is full-text post search with filters and a separate word mention trend by period.
Related
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents
A CLI and agent skill for website SEO audits: technical SEO, Core Web Vitals, structured data, security and AI search readiness
A marketplace of 22 Claude Code plugins: Yandex Direct, Metrika, Webmaster, Wordstat, SEO crawling, publishing and research
Five MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills