MaxStat MCP server

MaxStat MCP

Поиск и аналитика каналов и публикаций MAX в вашем AI-клиенте.

Разработчик и оператор: ООО «ФБМ Аналитикс» / FBM Analytics.

Русский · English

Получить API-токен · Подключить MaxStat MCP · 15 инструментов MCP · Что нового в MaxStat · Установка через AI-агента

Сервер работает на MaxStat. Здесь — плагины, skill, настройки подключения и документация. Исходный код сервера и базы данных закрыты.

Русский

Что нового

Мониторинг и уведомления. Отслеживайте каналы и ключевые фразы в публикациях и комментариях MAX. Получайте события в MAX, Telegram или на Webhook. Настройка — в личном кабинете.

Новости сервиса, API и MCP · Версии интеграции.

Возможности

Область	Какие данные возвращает MCP
Поиск каналов	Название, описание, URL, категория, тип доступа, диапазоны аудитории и числа публикаций, сортировка по релевантности, дате или аудитории
Карточка канала	ID, название, описание, аватар, URL, публичный или закрытый доступ, подписчики, публикации, категории, даты и статус РКН, когда он доступен
Динамика аудитории	Дневные значения, минимум, максимум, абсолютный и процентный рост за выбранный период
Просмотры и реакции	Суммарные, средние и максимальные значения на публикацию и дневная история
Активность канала	Число публикаций, дневная история и распределение по тексту, фото, видео, файлам и другим форматам
Поиск публикаций	Поиск по тексту, каналу, формату и датам; сортировка по просмотрам и реакциям
Карточка публикации	Текст и ссылки в нём, URL, вложения, просмотры, реакции, даты, признак удаления и источник пересылки
История публикации	Дневные значения просмотров и реакций
Пересылки	Найденные репосты, их URL, даты и ID каналов назначения
Тариф и расход	Статус тарифа, период, включённые, купленные, использованные и оставшиеся кредиты и история списаний

add_channel добавляет публичный или доступный по приглашению канал в очередь сбора данных MaxStat.

Мониторинг и Webhook настраиваются в личном кабинете. Через MCP они недоступны. Как настроить мониторинг.

Размер индекса

На 8 ноября 2026 года	Всего
Каналы MAX	672 837
Публикации	155 837 316
Категории	42

Источник: MaxStat.

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

1. Создайте токен в личном кабинете MaxStat API.
2. Не публикуйте токен и не добавляйте его в Git.
3. Выберите платформу ниже.
4. Перезапустите клиент и проверьте, что доступны 15 инструментов MaxStat.

Параметр	Значение
Endpoint	https://maxstat.ru/api/mcp
Транспорт	Streamable HTTP
Авторизация	API-токен
Заголовок	X-API-Token: <API_TOKEN>
Переменная окружения	MAXSTAT_API_TOKEN

Установка по платформам

Платформа	Способ
Codex / ChatGPT desktop	Репозиторий-маркетплейс и нативный Codex-плагин
Claude Code	Claude-compatible marketplace
VS Code	Agent Plugins marketplace или прямой .vscode/mcp.json
GitHub Copilot CLI	Общий Claude/Copilot marketplace
Gemini CLI	Gemini extension с защищённой настройкой токена
Cursor	Установка по ссылке или ~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
JetBrains AI Assistant	MCP-настройки IDE
Claude Desktop	Локальный мост mcp-remote
Cline	Удалённый Streamable HTTP из llms-install.md
Другие клиенты	Универсальный Streamable HTTP JSON

Codex

До запуска Codex сохраните токен в окружении:

export MAXSTAT_API_TOKEN="<API_TOKEN>"

Добавьте marketplace и установите плагин:

codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins

Готовые конфигурации передают токен в заголовке X-API-Token. При ручной настройке можно также использовать Authorization: Bearer <API_TOKEN>.

Для прямой установки без плагина объедините configs/codex.toml со своим ~/.codex/config.toml:

[mcp_servers.maxstat]
url = "https://maxstat.ru/api/mcp"
env_http_headers = { "X-API-Token" = "MAXSTAT_API_TOKEN" }

Claude Code

export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins

Прямая конфигурация находится в configs/claude-code.json.

Visual Studio Code

Добавьте marketplace в settings.json:

{
  "chat.plugins.marketplaces": ["fbmdata/maxstat-mcp"]
}

Откройте Extensions, найдите @agentPlugins, выберите MaxStat MCP и нажмите Install. Для прямого подключения скопируйте configs/vscode.json в .vscode/mcp.json. VS Code запросит токен в поле пароля.

GitHub Copilot CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins

Claude Code, VS Code и GitHub Copilot CLI используют один плагин и skill.

Gemini CLI

gemini extensions install https://github.com/fbmdata/maxstat-mcp

Расширение запросит токен и сохранит его как секретную настройку MAXSTAT_API_TOKEN. Инструкции для Gemini — в GEMINI.md.

Cursor

Перед запуском Cursor задайте MAXSTAT_API_TOKEN, затем нажмите кнопку выше. Альтернатива: объедините configs/cursor.json с ~/.cursor/mcp.json.

Cline

Задайте MAXSTAT_API_TOKEN до запуска Cline и передайте агенту llms-install.md. Он настроит подключение к https://maxstat.ru/api/mcp и проверит список инструментов.

Windsurf

Задайте MAXSTAT_API_TOKEN до запуска Windsurf и объедините configs/windsurf.json с ~/.codeium/windsurf/mcp_config.json. Токен подставляется из ${env:MAXSTAT_API_TOKEN}.

JetBrains AI Assistant

Откройте Settings → Tools → AI Assistant → Model Context Protocol (MCP), добавьте HTTP-конфигурацию из configs/jetbrains.json. Вставьте свой токен вместо <API_TOKEN> в настройках IDE.

Claude Desktop

Для Claude Desktop используйте локальный мост из configs/claude-desktop.json. Нужны Node.js и npm. Токен хранится в локальных настройках Claude Desktop. Облачному коннектору нужен OAuth 2.1, который MaxStat пока не поддерживает.

Универсальная конфигурация

Используйте configs/generic-mcp.json:

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

Инструменты MCP

Вызовы оплачиваются кредитами. Цены — в таблицах ниже.

Поиск и каталог

Инструмент	Что возвращает или делает	Кредиты
get_categories	Категории и число каналов в каждой	Бесплатно
search_channels	Каналы по фильтрам; сортировка и разбивка на страницы	3
get_channel	Карточка канала по ID	1
add_channel	Добавляет публичный или доступный по приглашению канал в очередь	Бесплатно
search_posts	Публикации по фильтрам; сортировка и разбивка на страницы	3

Аналитика каналов

Инструмент	Что возвращает	Кредиты
get_channel_subscribers	Минимум, максимум, абсолютный и процентный рост и дневную историю	5
get_channel_views	Суммарные, средние и максимальные просмотры и дневную историю	5
get_channel_likes	Суммарные, средние и максимальные реакции и дневную историю	5
get_channel_posts	Число публикаций, форматы и дневную историю активности	5

Аналитика публикаций

Инструмент	Что возвращает	Кредиты
get_post	Текст, вложения, показатели, источник пересылки и найденные репосты	1
get_post_views	Текущее число просмотров и дневную историю	5
get_post_likes	Общее число реакций, разбивку по типам и дневную историю	5

Тариф и использование

Инструмент	Что возвращает	Кредиты
get_account_subscription	Тариф, статус, период и состояние кредитов	Бесплатно
get_account_limits	Включённые, купленные, использованные и оставшиеся кредиты	Бесплатно
get_account_usage	Постраничную историю списаний по запросам	Бесплатно

Параметры и ограничения данных

• ID каналов и публикаций передаются строками, включая отрицательные ID. Не преобразуйте их в JavaScript Number: возможна потеря точности.
• В поиске limit — от 1 до 100, offset — от 0; offset + limit не больше 10 000. Для больших выборок уточняйте фильтры.
• search_channels сортирует по subscribers, posts, date или score. Для рейтинга по росту сначала получите кандидатов, затем запросите get_channel_subscribers за один период и отсортируйте их сами. Рейтинг охватывает только выбранные каналы.
• Даты date_from и date_to задаются как YYYY-MM-DD, обе границы включены. Истории каналов без дат используют последние 30 дней. Задавайте обе даты явно для сравнения; отсутствие снимков не означает нулевую аудиторию.
• get_post возвращает найденные пересылки при include_forwards=true. По умолчанию список не запрашивается. Пустой список не доказывает, что пересылок не было.
• search_posts поддерживает is_deleted: true — удалённые публикации, false — доступные, без параметра — обе группы. В карточке есть is_deleted, deleted_at и text_links; позиции ссылок — в единицах UTF-16.
• get_account_usage возвращает items, от новых к старым; limit — 1–100, offset — от 0. request_id связывает списание с запросом.

Ошибки и диагностика

REST API возвращает code, message, request_id и, если есть, details. MCP-клиент может оборачивать эту ошибку в результат вызова инструмента.

HTTP	Действие
401	Проверить токен: он отсутствует, истёк или отозван
402	Проверить активный период и остаток кредитов
403	Проверить доступность аккаунта
404	Проверить ID и наличие данных за период
422	Исправить параметры по details
429	Снизить частоту запросов и повторить позже
503	Повторить позже с учётом Retry-After, если он доступен клиенту

При обращении в поддержку передайте request_id, без API-токена. При Unknown tool обновите список инструментов в клиенте. Старые create_channel_subscription, create_keyword_subscription, get_subscriptions, get_subscription, update_subscription и delete_subscription удалены.

Мониторинг в личном кабинете

Настраивайте отслеживания в разделе «Мониторинг». Для активации нужен действующий платный тариф и свободное место: одно место входит в тариф, дополнительные покупаются в кабинете. Приостановленные мониторинги место не занимают.

Одно отслеживание — один канал или один ключевой запрос:

• Запрос содержит до 50 фраз и может искать по всему индексу MaxStat или по списку до 100 каналов. Запрос с таким фильтром занимает одно место.
• Для всех новых публикаций каждого из 50–100 каналов нужны 50–100 отдельных отслеживаний и столько же активных мест.
• Для каждого отслеживания действует лимит 1 000 событий в сутки по Москве.

События сохраняются в истории без Webhook. Для доставки добавьте получателя в разделе «Уведомления» и выберите его в мониторинге. Доступны личные чаты, группы и каналы MAX и Telegram, а также Webhook. Для Webhook нужен публичный HTTPS-адрес с действительным сертификатом. Один Webhook можно использовать в нескольких мониторингах. В одном мониторинге можно выбрать не больше одного получателя каждого типа. Лимиты доставки в мессенджеры на получателя: до 10 сообщений в минуту и 100 событий мониторинга в сутки по Москве.

Сервер Webhook должен ответить 2xx за 5 секунд. Перенаправлений и автоматических повторов доставки нет. Сохраняйте событие в очередь и обрабатывайте асинхронно, учитывая event_id для защиты от дублей. После 10 ошибок подряд без успеха за 24 часа Webhook отключается; успешная проверка кнопкой «Проверить» в «Уведомлениях» включает его снова.

Мониторинг собирает новые совпадения после создания или изменения условий. Старые публикации в историю не попадают. История хранится 90 дней. Состояние получателя, историю событий, лимиты и стоимость мест смотрите в кабинете.

Пример на реальных данных

Данные канала MAX • Анонсы на 29 июля 2026 года:

• канал MAX • Анонсы с аудиторией 3 496 789 подписчиков;
• рост с 3 054 001 до 3 496 789 с 30 июня по 29 июля: +442 788 / +14,5%;
• публикацию с 17 888 688 просмотрами и 187 460 реакциями;
• разбивку реакций, дневные истории просмотров и реакций;
• 184 найденных пересылки.

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

Найди 20 технологических каналов MAX с максимальным приростом подписчиков за
последние 30 дней. Верни ссылки, текущую аудиторию и процент роста.

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

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

Объясни, как в личном кабинете настроить мониторинг фраз «искусственный
интеллект» в 80 выбранных каналах и подключить Webhook.

Покажи мой тариф MaxStat, остаток кредитов и десять последних списаний.

Тарифы и безопасность

MCP входит во все тарифы MaxStat API. MCP и API расходуют общий баланс кредитов. Тариф, остаток кредитов и срок действия смотрите в кабинете или через get_account_subscription и get_account_limits.

Никогда не публикуйте настоящий API-токен в issue, PR, конфигурации, логе или скриншоте. Об уязвимостях сообщайте по инструкции из SECURITY.md.

English

What's new

Monitoring and notifications. Track channels and keyword matches in MAX posts and comments. Receive events in MAX, Telegram, or through a webhook. Configure them in the dashboard.

Service, API, and MCP news (Russian) · Integration versions.

Search MAX channels and posts, compare audience growth, views and reactions, and find forwards from your AI client.

As of November 8, 2026: 672,837 channels, 155,837,316 posts, 42 categories. Source: MaxStat.

Connection

Parameter	Value
Endpoint	https://maxstat.ru/api/mcp
Transport	Streamable HTTP
Header	X-API-Token: <API_TOKEN>
Token dashboard	maxstat.ru/dashboard/api

Install

Codex

export MAXSTAT_API_TOKEN="<API_TOKEN>"
codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins

Claude Code

export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins

GitHub Copilot CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins

Gemini CLI

gemini extensions install https://github.com/fbmdata/maxstat-mcp

For VS Code, Cursor, Windsurf, JetBrains AI Assistant, Claude Desktop, and other clients, use configs/. Setup steps are in the Russian section above.

Capabilities

• Search and filter MAX channels and publications.
• Retrieve channel profiles, audience growth, views, reactions, activity, and content-format mix.
• Retrieve post text, attachments, metrics, reaction details, histories, and detected forwards.
• Add a MAX channel to the collection queue; this does not create monitoring.
• Inspect the active MaxStat plan, credit balance, and request-level usage.

See Инструменты MCP for all 15 tools, credit costs, limits, and errors. Channel and post IDs are strings; search pages contain 1–100 items and offset + limit cannot exceed 10,000. Use get_post with include_forwards=true to request detected forwards.

Monitoring and webhooks

Set up monitoring in the dashboard. MCP cannot manage it. The six old webhook-subscription tools have been removed; get_account_subscription returns your billing plan.

An active paid plan includes one monitoring slot; extra slots are purchased separately. Paused monitors do not occupy slots. One monitor tracks one channel or one keyword query of up to 50 phrases, optionally restricted to 100 channels. A query covering 80 channels takes one slot; collecting every new post from 80 channels takes 80 monitors and active slots. Each monitor records up to 1,000 events per Moscow calendar day; history is retained for 90 days.

Webhook delivery needs a public HTTPS endpoint. Add a recipient in Notifications and select it in the monitor. MAX and Telegram support private chats, groups, and channels. Messenger delivery is limited to 10 messages per minute and 100 monitoring events per Moscow calendar day per recipient. One webhook can serve several monitors, with at most one recipient of each type per monitor. Respond with 2xx within five seconds; redirects and automatic delivery retries are not supported. Deduplicate by event_id. A webhook is disabled after ten consecutive failures without a success for 24 hours; a successful dashboard check re-enables it. Historical events are not backfilled.

Cloud connectors

Use a client that can send the X-API-Token header. Hosted ChatGPT and Claude connectors need OAuth 2.1, which MaxStat does not yet support.

Ссылки / Links

• MaxStat MCP
• Получить API-токен / Get a token
• Документация API / API documentation
• Тарифы API / API plans
• ООО «ФБМ Аналитикс» / FBM Analytics
• MaxStat Insights в MAX
• FBM API Insights в Telegram

Лицензия / License

Лицензия MIT покрывает файлы этого репозитория: плагины, skill, конфигурации, документацию и проверки. Условия использования сервиса, API, данных и товарных знаков — отдельно. Подробности — в NOTICE.