limzo-mcp
OfficialIt is a read-only MCP server for public Limzo Telegram group statistics, with no API key required.
list_groups— search or browse public Telegram groups by keyword and language; returns slug, title, member count, language mix, 7-day activity, plan, and Limzo Score.get_group_stats— fetch full public stats for a group by slug: messages, active users, daily trends, top members, mood, languages, levels, leagues, reactions, and moderation-related status flags; supports 7d/30d/all ranges (with plan fallback to 7d).get_global_stats— get network-wide totals: public group count, messages, active users, replies, reactions, karma, members tracked, and spam removed.Works as a stdio MCP server via
npx limzo-mcp, or connect directly over HTTP to the hosted streamable MCP endpoint.Privacy-safe: never exposes verbatim member messages; private groups are anonymised and excluded from the directory.
Provides access to public Telegram group statistics such as leaderboards, activity trends, member levels, weekly awards, and moderation summaries for groups with public Limzo stats pages.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
limzo-mcp
MCP (Model Context Protocol) server for Limzo, the Telegram anti-spam and moderation bot — read-only public Telegram group statistics: leaderboards, activity trends, member levels, weekly award history, and moderation summaries for any group with a public Limzo stats page.
No API key, no account. Everything served is already public at limzo.com/s/<slug> — payloads never include verbatim member messages.
Tools
Tool | What it returns |
| Search/browse the public group directory (slug, title, members, language) |
| Full public stats for one group by slug: activity, top members, levels, awards, moderation summary |
| Network-wide Limzo stats |
Related MCP server: Shadow-tg
Quick start
The server is hosted — this package is a stdio bridge for MCP clients:
npx limzo-mcpClaude Desktop / Claude Code
{
"mcpServers": {
"limzo": { "command": "npx", "args": ["-y", "limzo-mcp"] }
}
}Cursor / other MCP clients
Same pattern — command npx, args ["-y", "limzo-mcp"].
Direct HTTP (streamable MCP, no bridge)
Clients that support remote MCP can connect straight to:
https://limzo.com/api/public/mcpExample
Ask an assistant "How active is the hipo_chat Telegram group?" and it calls get_group_stats:
// get_group_stats { "slug": "hipo" } → (response trimmed)
{
"group": { "title": "Hipo Chat", "username": "hipo_chat", "member_count": 3920 },
"range": { "key": "7d", "label": "7 days", "days": 7 },
"stats": {
"messages": 1107,
"active_users": 236,
"mood": { "label": "Sunny", "emoji": "☀️", "positive_pct": 83 },
"top_members": [
{ "rank": 1, "name": "Josip", "messages": 238 },
{ "rank": 2, "name": "Behrang Norouzinia", "messages": 84 }
]
}
}Every value above is already public at limzo.com/s/hipo — the server never exposes verbatim member messages. Full response shape: openapi.json.
What is Limzo?
A Telegram community bot: public shareable stats pages, member levels/badges/achievements, weekly highlights and reports, mini-games, and smart anti-spam moderation (newcomer captcha, impersonator guard, link safety scan, /warn warnings, language lock, cross-group network shield). Free to start: @LimzoRobot.
Docs: https://limzo.com/docs/
llms.txt: https://limzo.com/llms.txt
Listed on
Official MCP Registry (com.limzo/telegram-group-stats) · Glama · Smithery · npm
License
MIT
Available Tools
3 toolsget_global_statsGet network-wide Limzo totalsARead-onlyInspect
Call this for network-wide numbers across all public Telegram groups tracked by Limzo (group count, messages, active users, replies, reactions, karma — 7-day and all-time) plus durable lifetime totals (messages analyzed, members tracked, spam messages removed) and the current top groups by Limzo Score. For finding a specific group, prefer list_groups.
Inputs: no named parameters. Returns: Network-wide totals across all listed public groups.
get_group_statsGet public stats for one Telegram groupARead-onlyInspect
Call this when the user asks about the activity, health, leaderboard, mood, or trends of a specific Telegram group tracked by Limzo. slug is the last part of the group's public page URL, limzo.com/s/ (e.g. "hipo"). Returns the curated limzo.public_stats/v1 JSON: messages, replies, active members, daily series, top members, mood, reactions, language mix, the Limzo Levels ladder (lifetime XP + badge tiers), and weekly-league standings when the group has the league enabled. Optional range: 7d (default), 30d, all — the wider ranges only serve real data for groups on a paid plan and otherwise silently fall back to 7d, so check range.key in the result. Never includes verbatim member messages. For a private group (one with no public t.me handle) the member identities, the group description and member_count are withheld too: aggregates plus an anonymised leaderboard are all it returns.
Inputs: slug (required), range. Returns: Curated, versioned public stats payload. Never includes verbatim member message…
list_groupsList or search public Telegram groupsARead-onlyInspect
Call this to discover Telegram groups tracked by Limzo — to browse the directory, filter by language, or find a group's slug for get_group_stats. Optional query filters case-insensitively over group title, username, slug, and description. Optional lang (ISO 639-1, e.g. "fa", "es") keeps only groups where that language is a meaningful share of what members write — the way to answer "find active Persian/Spanish groups". Omit both to list the top groups by Limzo Score. The directory covers PUBLIC groups only — a group with no t.me handle is never listed, though it may still have a /s/ page. Each row carries a language mix (primary language + top languages as percentages); rows also include slug, title, username, plan, member_count, 7-day messages and active members, score and page URLs, plus total_matches so you can tell when more groups matched than were returned.
Inputs: lang, limit, query. Returns: Compact directory rows for discovering groups. Sorted by Limzo Score.
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 serves a distinct purpose: list_groups for discovery, get_global_stats for network-wide metrics, and get_group_stats for a specific group. There is no overlap or ambiguity, as the descriptions explicitly clarify when to use each one.
All three tools follow a consistent verb_noun pattern (list_groups, get_global_stats, get_group_stats) with the same prefix structure and clear, readable naming. The convention is uniform and predictable.
With only 3 tools, the server is tightly scoped to its purpose of retrieving Limzo data: listing groups, global stats, and individual group stats. Each tool is essential and non-redundant, fitting comfortably within the typical 3-15 range.
The tool surface fully covers the domain of a read-only stats server: discovery via list_groups, network overview via get_global_stats, and detailed group analysis via get_group_stats. There are no missing operations needed for the server's stated purpose.
Maintenance
Related MCP Connectors
Live Telegram data: trending topics, channel profiles & metrics, post history incl. edits/deletions.
I use your linked Telegram MTProto session (Integrations → Telegram) to list groups, members, and s…
Search 1.7M+ Telegram channels, 250k+ chats, 228k+ bots, and what chats ask for. No key, no install.
Read-only GitHub trending data: top repos by stars gained today, this week or this month.
Related MCP Servers
- FlicenseNot gradedqualityBmaintenanceRead-only MCP access to a personal Telegram account. Allows querying chats, reading and searching messages via Streamable HTTP.-
- AlicenseNot gradedqualityCmaintenanceRead public Telegram channels from AI agents — channel metadata, posts, comments, and search. No MTProto, no Telethon, no api_id.1MIT
- AlicenseNot gradedqualityBmaintenancePublic Telegram catalog MCP server: search 1.4M+ channels, groups, bots, and posts, and browse marketplace listings, with no auth or API key.1MIT
- FlicenseNot gradedqualityDmaintenanceRead-only MCP server for Telegram channels. Provides access to posts, comments, reactions, and aggregated statistics via MTProto.58 npm-