Maxstat MCP Server

MaxStat MCP

The official remote MCP server for analytics of channels and posts in the MAX messenger.

English · Русский

The MCP server is hosted by MaxStat. This repository contains its public manifest, connection examples, and documentation; the server-side implementation and MaxStat data are not published here.

English

Connect MaxStat to Codex, Claude Code, Cursor, Claude Desktop, or any Streamable HTTP MCP client. An AI agent can search MAX channels and posts, inspect audience and engagement metrics, compare performance over time, and use the results in reports, research, and product prototypes.

What you can do

• Find channels by name, description, link, category, audience size, or post count.
• Search posts by text, channel, format, date, views, or likes.
• Track subscriber growth, views, reactions, and publishing activity.
• Compare channels and prepare structured analytics.
• Add a public or invite-only MAX channel to the MaxStat tracking queue.
• Use current MAX data while building dashboards, reports, and prototypes.

Connection details

1. Get an API token

Open the MaxStat API dashboard and create a token. The Test Drive plan activates on the first API request and provides 1,000 credits every 30 days.

Keep the token secret. Use an environment variable whenever your MCP client supports one, and never commit a real token to a repository.

2. Connect your client

Claude Code

claude mcp add --transport http maxstat https://maxstat.ru/api/mcp \
  --header "X-API-Token: <API_TOKEN>"

Codex CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"

codex mcp add maxstat \
  --url https://maxstat.ru/api/mcp \
  --bearer-token-env-var MAXSTAT_API_TOKEN

Cursor

Add the server to your MCP configuration:

{
  "mcpServers": {
    "maxstat": {
      "url": "https://maxstat.ru/api/mcp",
      "headers": {
        "X-API-Token": "${env:MAXSTAT_API_TOKEN}"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "maxstat": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://maxstat.ru/api/mcp",
        "--header",
        "X-API-Token:${MAXSTAT_API_TOKEN}"
      ],
      "env": {
        "MAXSTAT_API_TOKEN": "<API_TOKEN>"
      }
    }
  }
}

Generic MCP client

{
  "mcpServers": {
    "maxstat": {
      "type": "streamable-http",
      "url": "https://maxstat.ru/api/mcp",
      "headers": {
        "X-API-Token": "<API_TOKEN>"
      }
    }
  }
}

Available tools

The server exposes current public MaxStat API operations as MCP tools.

Example prompts

Find 20 fast-growing technology channels in MAX over the last 30 days.

Compare these five channels by subscribers, view growth, and publishing frequency.

Find posts about mortgages published in June and return their links, views, and reactions.

Build a channel ranking page in this project and use MaxStat MCP as the data source.

Usage and billing

MCP access is included in all MaxStat API plans at no additional charge. MCP calls and direct API requests consume the same credit allowance. See API plans and limits.

Русский

MaxStat MCP подключает актуальные данные о каналах и публикациях в MAX к Codex, Claude Code, Cursor, Claude Desktop и другим MCP-клиентам. AI-агент может самостоятельно выбирать инструменты MaxStat, выполнять поиск и собирать аналитику прямо в рабочем контексте.

Возможности

• Поиск каналов по названию, описанию, ссылке, категории и размеру аудитории.
• Поиск публикаций по тексту, каналу, формату, датам, просмотрам и лайкам.
• Анализ динамики подписчиков, просмотров, реакций и частоты публикаций.
• Сравнение каналов и подготовка аналитических отчётов.
• Добавление публичных и пригласительных MAX-каналов в очередь отслеживания.
• Использование данных MAX при создании прототипов, интерфейсов и исследований.

Быстрый старт

1. Получите токен в личном кабинете MaxStat API.
2. Выберите конфигурацию для своего клиента в разделе Connect your client.
3. Замените <API_TOKEN> своим токеном или сохраните его в переменной окружения.
4. Перезапустите MCP-клиент и проверьте, что инструменты MaxStat появились в списке.

Test Drive активируется при первом API-запросе и предоставляет 1 000 кредитов каждые 30 дней. MCP входит во все тарифы API без дополнительной оплаты; MCP и прямой API используют общий лимит операций.

Примеры запросов

Найди 20 быстрорастущих каналов MAX о технологиях за последние 30 дней.

Сравни эти пять каналов по числу подписчиков, динамике просмотров и частоте публикаций.

Найди публикации про ипотеку за июнь и верни ссылки, просмотры и реакции.

Создай в проекте страницу рейтинга каналов MAX и используй MaxStat MCP для получения данных.

Links / Ссылки

• MaxStat MCP
• Get an API token / Получить API-токен
• API documentation / Документация API
• API plans / Тарифы API
• MaxStat Insights in MAX
• FBM API Insights in Telegram

For documentation and configuration problems, open a GitHub issue. To report a security vulnerability, follow SECURITY.md.

License

Files published in this repository are available under the MIT License. The license does not apply to the MaxStat service, API, data, trademarks, or server-side implementation. See NOTICE for details.