MaxStat MCP

io.github.fbmdataPublished by GitHub account fbmdatav1.2.3Updated Oct 24, 2026

Search 408K+ MAX channels and 86M+ posts; metrics, reactions, forwards, webhooks and usage.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingCommunication & CollaborationData & Analytics

Overview

AI-generated overview

Remote MaxStat MCP server giving assistants structured search and analytics over MAX messenger channels and posts, plus webhook monitoring.

What you can do
  • Search and browse MAX channels and posts, with filters, sorting, pagination and category counts
  • Read channel profiles, subscriber growth, views, reactions and publishing activity with daily histories
  • Read post content, attachments, metrics, reaction breakdowns, daily histories and detected forwards
  • Create and manage webhook subscriptions for new channel posts or keyword/category matches
  • Check the account plan, credit balance and request-level usage history
When to use it
Useful when you need structured data on MAX messenger channels and publications: audience growth comparisons, post performance and reaction analysis, forward tracking, or alerts on new posts by channel or keyword.
Requirements
Remote Streamable HTTP endpoint at maxstat.ru/api/mcp; no local package needed. A MaxStat API token is required and sent in the X-API-Token header (the README also shows a MAXSTAT_API_TOKEN environment variable for clients that substitute it). Claude Desktop needs a local mcp-remote bridge with Node.js and npm. Webhook callbacks must be publicly reachable over HTTPS.
Before you install
The X-API-Token is a secret: keep it out of repositories, logs, issues and screenshots. Calls consume a shared credit balance (for example 3 credits per channel or post search, 5 per analytics call, 2-3 per webhook delivery); a Test Drive grants 1,000 credits every 30 days. Tools can add channels to a tracking queue and create, update or delete webhook subscriptions, which send data to third-party callback URLs. Queries and results go to the MaxStat service.

Installation

In SourceWeft

  1. Open MaxStat MCP in the dashboard and add it to a workspace.
  2. Connect X-API-Token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.fbmdata%2Fmaxstat-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

MaxStat MCP

[MCP] [Tools] [Version] [License: MIT] [Official MCP Registry] [Glama]

Официальный удалённый MCP-сервер MaxStat для поиска, аналитики и мониторинга каналов и публикаций в мессенджере MAX.

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

Русский · English

Получить бесплатный API-токен · Подключить MaxStat MCP · Посмотреть все 21 инструмент · Инструкция для AI-установщика

[Демонстрация MaxStat MCP]

MaxStat размещает и обслуживает MCP-сервер. В репозитории опубликованы манифесты, плагины, аналитический skill, клиентские конфигурации и документация. Серверная реализация и данные MaxStat не являются открытым исходным кодом.

Русский

Что именно можно получить через MaxStat MCP

AI-агент подключается к живому индексу каналов и публикаций MAX и получает структурированные данные, а не фрагменты поисковой выдачи или вручную собранные скриншоты.

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

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

Проверенный масштаб индекса

Проверено 29 июля 2026 годаЖивой индекс
Каналы MAX408 501
Публикации86 315 758
Категории каналов42
MCP-инструменты21

Это показатели production на maxstat.ru, а не staging-окружения. Индекс постоянно растёт. Используйте search_channels, search_posts и get_categories, чтобы получить актуальные результаты.

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

  1. Создайте токен в личном кабинете MaxStat API.
  2. Не публикуйте токен и не добавляйте его в Git.
  3. Выберите платформу ниже.
  4. Перезапустите клиент и проверьте, что доступны 21 инструмент MaxStat.
ПараметрЗначение
Endpointhttps://maxstat.ru/api/mcp
ТранспортStreamable HTTP
АвторизацияAPI-токен
ЗаголовокX-API-Token: <API_TOKEN>
Переменная окруженияMAXSTAT_API_TOKEN

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

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

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

bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"

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

bash
codex plugin marketplace add fbmdata/maxstat-mcpcodex plugin add maxstat@maxstat-plugins

Плагин подключает MCP с правильным пользовательским заголовком X-API-Token. Не используйте Bearer-настройку: она отправляет другой заголовок и не подходит для MaxStat.

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

toml
[mcp_servers.maxstat]url = "https://maxstat.ru/api/mcp"env_http_headers = { "X-API-Token" = "MAXSTAT_API_TOKEN" }
Claude Code
bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"claude plugin marketplace add fbmdata/maxstat-mcpclaude plugin install maxstat@maxstat-plugins

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

Visual Studio Code

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

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

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

GitHub Copilot CLI
bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"copilot plugin marketplace add fbmdata/maxstat-mcpcopilot plugin install maxstat@maxstat-plugins

Claude Code, VS Code и GitHub Copilot CLI используют один совместимый плагин, skill и MCP-конфигурацию.

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

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

Cursor

[Add MaxStat MCP to Cursor]

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

Cline

Задайте MAXSTAT_API_TOKEN до запуска Cline и передайте агенту llms-install.md. Файл содержит конфигурацию удалённого Streamable HTTP-сервера и проверку подключения. Локальный npm-пакет не нужен: MaxStat размещает и обслуживает сервер на 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. JetBrains пока не документирует подстановку переменной окружения в MCP headers, поэтому placeholder оставлен намеренно.

Claude Desktop

Облачный custom connector Claude не принимает произвольный пользовательский X-API-Token. До внедрения OAuth 2.1 используйте локальный мост из configs/claude-desktop.json. Требуются Node.js и npm; токен сохраняется только в локальной конфигурации Claude Desktop.

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

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

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

Все 21 инструмент

Поиск и каталог
ИнструментЧто возвращает или делаетКредиты
get_categoriesКатегории и актуальное количество каналов в каждой категорииБесплатно
search_channelsОтфильтрованные, отсортированные и постраничные карточки каналов3
get_channelПолная карточка одного канала по идентификатору1
add_channelДобавляет публичный или invite-only канал в очередьБесплатно
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
Webhook-мониторинг
ИнструментЧто возвращает или делаетКредиты
create_channel_subscriptionПодписывает публичный HTTPS callback на новые публикации каналаСоздание бесплатно; 2 за доставку
create_keyword_subscriptionПодписывает callback на публикации по запросу и категорииСоздание бесплатно; 3 за доставку
get_subscriptionsСписок подписок с фильтрами по статусу и типуБесплатно
get_subscriptionОдна подписка, состояние доставки и последняя ошибкаБесплатно
update_subscriptionИзменение callback URL, пауза или возобновлениеБесплатно
delete_subscriptionУдаление webhook-подпискиБесплатно

Webhook должен быть доступен по публичному HTTPS-адресу.

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

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

Проверочный запрос к production 29 июля 2026 года вернул:

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

Значения показывают структуру реального ответа и не являются обещанием фиксированных показателей продукта.

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

text
Найди 20 технологических каналов MAX с максимальным приростом подписчиков запоследние 30 дней. Верни ссылки, текущую аудиторию и процент роста.
text
Сравни пять каналов по аудитории, средним просмотрам, реакциям, частотепубликаций и распределению форматов.
text
Найди публикации об ипотеке за июль. Верни ссылки, текст, вложения, просмотры,детальные реакции и найденные пересылки.
text
Подпиши webhook на новые публикации со словами «искусственный интеллект» вкатегории «Технологии».
text
Покажи мой тариф MaxStat, остаток кредитов и десять последних списаний.

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

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

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

English

MaxStat MCP gives AI agents structured access to the live MAX messenger channel and publication index. It supports channel and post discovery, daily audience, view and reaction histories, publishing activity, attachment and reaction details, forward detection, webhook monitoring, and account credit usage. The production index was verified on July 29, 2026 with 408,501 channels, 86,315,758 posts, 42 channel categories, and 21 MCP tools.

Connection

ParameterValue
Endpointhttps://maxstat.ru/api/mcp
TransportStreamable HTTP
HeaderX-API-Token: <API_TOKEN>
Token dashboardmaxstat.ru/dashboard/api

Install

Codex
bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"codex plugin marketplace add fbmdata/maxstat-mcpcodex plugin add maxstat@maxstat-plugins
Claude Code
bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"claude plugin marketplace add fbmdata/maxstat-mcpclaude plugin install maxstat@maxstat-plugins
GitHub Copilot CLI
bash
export MAXSTAT_API_TOKEN="<API_TOKEN>"copilot plugin marketplace add fbmdata/maxstat-mcpcopilot plugin install maxstat@maxstat-plugins
Gemini CLI
bash
gemini extensions install https://github.com/fbmdata/maxstat-mcp

For VS Code, Cursor, Windsurf, JetBrains AI Assistant, Claude Desktop, and generic clients, use the checked-in configs/ directory. The Russian section above contains detailed client-specific instructions.

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.
  • Create and manage channel or keyword webhook subscriptions.
  • Inspect the active MaxStat plan, credit balance, and request-level usage.

The complete 21-tool contract and credit costs are documented in Все 21 инструмент.

Authentication boundary

This release supports clients that can send the custom X-API-Token header. Publishing as a fully hosted ChatGPT or Claude cloud connector requires a separate OAuth 2.1 implementation.

Ссылки / Links

Лицензия / License

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

Source: README.md at commit 121e985

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.2.3LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts