# Limzo Telegram Group Stats

Limzo Telegram Group Stats retrieves public analytics for Telegram communities tracked by the Limzo moderation bot. Works out of the box without API keys or accounts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: LimzoCom
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/LimzoCom/limzo-mcp
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/limzo-telegram-group-stats

## What it does

The package exposes three functions to the assistant: `list_groups` to explore the open directory, `get_group_stats` for individual chat metrics, and `get_global_stats` for network totals. Responses contain member leaderboards, activity counts, participant levels, weekly prizes, and automated moderation logs.

All information mirrors public dashboards at `limzo.com/s/<slug>`. The server filters out raw chat text entirely, returning solely aggregate numbers. If a Telegram group does not run Limzo or keeps its web stats hidden, this integration cannot query it.

Setup takes zero credentials. MCP clients can link straight to the remote endpoint `https://limzo.com/api/public/mcp` or run the local stdio runner via `npx -y limzo-mcp`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://limzo.com/api/public/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http telegram-group-stats https://limzo.com/api/public/mcp
```

2. **Platform CLI**
```bash
claude mcp add limzo-telegram-group-stats -- npx -y limzo-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add limzo-telegram-group-stats --url https://limzo.com/api/public/mcp
```

2. **Platform CLI**
```bash
codex mcp add limzo-telegram-group-stats -- npx -y limzo-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "limzo-telegram-group-stats": {
            "url": "https://limzo.com/api/public/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "limzo-telegram-group-stats": {
            "command": "npx",
            "args": [
                "-y",
                "limzo-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "limzo-telegram-group-stats": {
            "type": "http",
            "url": "https://limzo.com/api/public/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "limzo-telegram-group-stats": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "limzo-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http limzo-telegram-group-stats https://limzo.com/api/public/mcp
```

2. **Platform CLI**
```bash
gemini mcp add limzo-telegram-group-stats npx -y limzo-mcp
```

## When to use it
- Inspect participant rankings and activity trends for a specific Telegram group
- Search the public directory of communities by title or language
- Check recent moderation metrics without opening a browser
- Fetch overall network engagement numbers across all tracked chats

## Example prompts
- Show me member rankings and recent activity for group slug `hipo`
- Search Limzo for public English Telegram communities
- What are the global network statistics across Limzo right now?

## Similar
- [telegram-group-analytics-bot](https://affpapa.org/en/nevibecode/skills/telegram-group-analytics-bot.md) — skill · 615 installs
- [telegram-group-statistics-analytics-bot](https://affpapa.org/en/nevibecode/skills/telegram-group-statistics-analytics-bot.md) — skill · 610 installs
- [telegram-archive-mcp](https://affpapa.org/en/nevibecode/mcp/telegram-archive-mcp.md) — MCP server · ★ 16 repo stars
- [telegram](https://affpapa.org/en/nevibecode/skills/telegram.md) — skill · 486 installs
- [Chatroost — unofficial Telegram MCP server](https://affpapa.org/en/nevibecode/mcp/chatroost-unofficial-telegram-mcp-server.md) — MCP server · ★ 72 repo stars
- [fast-mcp-telegram](https://affpapa.org/en/nevibecode/mcp/fast-mcp-telegram.md) — MCP server · ★ 50 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
