Limzo Telegram Group Stats

Official3 tools

by LimzoCom · JavaScript

Read-only stats for public Telegram groups tracked by Limzo, the anti-spam bot. No API key.

com.limzo/telegram-group-stats MCP Server

This MCP server provides read-only access to public Telegram group statistics from Limzo. It exposes data such as leaderboards, activity, and levels, and it operates without requiring an API key. The server focuses on retrieving publicly available group stats for catalog consumers and developers.

🛠️ Key Features

Read-only public Telegram group stats from Limzo
Leaderboards, activity, and levels data
No API key required

🚀 Use Cases

Display or analyze public Telegram group leaderboards
Review Telegram group activity trends
Track or surface level-related statistics

⚡ Developer Benefits

Simple integration for public stats retrieval
Consistent tooling scope (3 tools) aligned to stats data

⚠️ Limitations

Limited to public Telegram group statistics
Read-only access only

Topics

analyticscommunity-managementgroup-statisticsmcpmcp-servermodel-context-protocoltelegramtelegram-botcommunitymoderation-bottelegram-analytics

Captured live from the server via tools/list.

get_group_stats

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/<slug> (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.

Parameters2

slug	string	required	The group's public slug — the last part of its limzo.com/s/<slug> URL.
range	string	optional	Stats window. Defaults to 7d. 30d/all require the group's paid plan; free groups silently fall back to 7d.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The group's public slug — the last part of its limzo.com/s/<slug> URL."
    },
    "range": {
      "type": "string",
      "enum": [
        "7d",
        "30d",
        "all"
      ],
      "description": "Stats window. Defaults to 7d. 30d/all require the group's paid plan; free groups silently fall back to 7d."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

list_groups

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.

Parameters3

query	string	optional	Keyword matched case-insensitively against group title, username, slug, and description. Omit to list the top groups by Limzo Score.
lang	string	optional	ISO 639-1 language code (e.g. "fa", "es", "en"). Keeps groups whose main language it is (the detected top language, or the admin's chosen one when both are languages Limzo speaks) or where it is a meaningful share of the group.
limit	integer	optional	Maximum groups to return. Defaults to 20, capped at 50.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keyword matched case-insensitively against group title, username, slug, and description. Omit to list the top groups by Limzo Score."
    },
    "lang": {
      "type": "string",
      "description": "ISO 639-1 language code (e.g. \"fa\", \"es\", \"en\"). Keeps groups whose main language it is (the detected top language, or the admin's chosen one when both are languages Limzo speaks) or where it is a meaningful share of the group."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Maximum groups to return. Defaults to 20, capped at 50."
    }
  },
  "additionalProperties": false
}

get_global_stats

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

README.md3 KBView 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:

bash

npx limzo-mcp

Claude Desktop / Claude Code

json

{
  "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:

code

https://limzo.com/api/public/mcp

Example

Ask an assistant "How active is the hipo_chat Telegram group?" and it calls get_group_stats:

jsonc

// 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

Install

Tools (3)

get_group_statslist_groupsget_global_stats

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "telegram-group-stats": {
      "command": "npx",
      "args": [
        "-y",
        "limzo-mcp@1.3.1"
      ]
    }
  }
}

com.limzo/telegram-group-stats MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

get_group_stats

list_groups

get_global_stats

limzo-mcp

Tools

Quick start

Claude Desktop / Claude Code

Cursor / other MCP clients

Direct HTTP (streamable MCP, no bridge)

Example

What is Limzo?

Listed on

License

Install

Related servers