Limzo Telegram Group Stats
Read-only stats for public Telegram groups tracked by Limzo, the anti-spam bot. No API key.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http limzo-telegram-group-stats 'https://limzo.com/api/public/mcp'
{
"mcpServers": {
"limzo-telegram-group-stats": {
"type": "http",
"url": "https://limzo.com/api/public/mcp"
}
}
}
limzo-mcpclaude mcp add limzo-telegram-group-stats -- npx -y limzo-mcp@1.3.1
{
"mcpServers": {
"limzo-telegram-group-stats": {
"command": "npx",
"args": [
"-y",
"limzo-mcp@1.3.1"
]
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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 |
|---|---|
list_groups | Search/browse the public group directory (slug, title, members, language) |
get_group_stats | Full public stats for one group by slug: activity, top members, levels, awards, moderation summary |
get_global_stats | Network-wide Limzo stats |
Quick start
The server is hosted — this package is a stdio bridge for MCP clients:
npx limzo-mcp
Claude 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/mcp
Example
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/
- OpenAPI: https://limzo.com/api/public/openapi.json
- llms.txt: https://limzo.com/llms.txt
Listed on
Official MCP Registry (com.limzo/telegram-group-stats) · Glama · Smithery · npm
License
MIT
Frequently asked questions
What is Limzo Telegram Group Stats?
Read-only stats for public Telegram groups tracked by Limzo, the anti-spam bot. No API key.
How do I install Limzo Telegram Group Stats?
It runs as a remote server. In Claude Code: claude mcp add --transport http limzo-telegram-group-stats 'https://limzo.com/api/public/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Limzo Telegram Group Stats need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Limzo Telegram Group Stats open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Limzo Telegram Group Stats?
It is published by LimzoCom. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.