Repository navigation
Description
👋 A self-contained first contribution: one JSON adapter file, a spec and a logo. No need to know the rest of the codebase.
Why this one
In the last 30 days, 2 different workspaces on AnythingMCP Cloud searched the catalog for TGStat and found nothing. People want it; nobody has built it yet.
The API
- Docs: https://api.tgstat.ru/docs/ru/start/intro.html
- Auth: an API token in the
tokenquery parameter - Category: Analytics
Suggested first tools (read-only)
get channel info, get channel statistics, search posts, get a post's statistics. Read-only tools are enough for a first version; write tools can follow in a later PR.
How
Follow the six steps in AGENTS.md → Add an adapter and docs/tool-definition.md. The scaffold command for this one:
npm run adapter:new -- tgstat --region intl --auth QUERY_AUTHThen node scripts/validate-adapters.mjs --warn, node scripts/regenerate-catalog.mjs, a intl/tgstat.live.spec.ts (static assertions always, live calls behind RUN_TGSTAT_LIVE=1), node scripts/adapter-count.mjs --check and the logo. The walkthrough and past examples are in #982.
Done when
- The adapter validates without new warnings and the catalog is regenerated.
- Every tool has a description an AI can act on (what it returns, when to use it) and a response mapping that keeps the useful fields.
- The PR says which calls you ran against a real account, or that you could not and built it from the docs.
Claim it
Comment here to claim it. A claim without a PR for 14 days goes back to the pool, no hard feelings. Sign the CLA when the bot asks.
Activity
abinyads-dev commentedon Nov 4, 2026
I would like to claim this issue and add the TGStat adapter (
QUERY_AUTH, read-only tools for channel info, statistics, post search and stats) with validation, catalog generation, live spec, and SVG logo.helpcodeai commentedon Nov 4, 2026
Thanks @abinyads-dev, it's yours. I reviewed your PR #1518 and left a few small changes there.