{ "markdown": "# MaxStat MCP\n\n[![MCP](https://img.shields.io/badge/MCP-Streamable%20HTTP-4830E6)](https://modelcontextprotocol.io/)\n[![Tools](https://img.shields.io/badge/MCP_tools-21-4830E6)](#все-21-инструмент)\n[![Version](https://img.shields.io/badge/release-1.2.3-4830E6)](CHANGELOG.md)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![Official MCP Registry](https://img.shields.io/badge/Official_MCP_Registry-live-2EA44F)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.fbmdata%2Fmaxstat-mcp)\n[![Glama](https://img.shields.io/badge/Glama-listed-2EA44F)](https://glama.ai/mcp/connectors/io.github.fbmdata/maxstat-mcp)\n\n**Официальный удалённый MCP-сервер MaxStat для поиска, аналитики и мониторинга\nканалов и публикаций в мессенджере MAX.**\n\nРазработчик и оператор: **ООО «ФБМ Аналитикс» / FBM Analytics**.\n\n[Русский](#русский) · [English](#english)\n\n[Получить бесплатный API-токен](https://maxstat.ru/dashboard/api) ·\n[Подключить MaxStat MCP](#быстрый-старт) ·\n[Посмотреть все 21 инструмент](#все-21-инструмент) ·\n[Инструкция для AI-установщика](llms-install.md)\n\n![Демонстрация MaxStat MCP](assets/maxstat-mcp-demo.gif)\n\n> MaxStat размещает и обслуживает MCP-сервер. В репозитории опубликованы\n> манифесты, плагины, аналитический skill, клиентские конфигурации и\n> документация. Серверная реализация и данные MaxStat не являются открытым\n> исходным кодом.\n\n## Русский\n\n### Что именно можно получить через MaxStat MCP\n\nAI-агент подключается к живому индексу каналов и публикаций MAX и получает\nструктурированные данные, а не фрагменты поисковой выдачи или вручную собранные\nскриншоты.\n\n| Область | Какие данные возвращает MCP |\n| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |\n| Поиск каналов | Название, описание, URL, категория, тип доступа, диапазоны аудитории и числа публикаций, сортировка по релевантности, дате или аудитории |\n| Карточка канала | ID, название, описание, аватар, URL, публичный или закрытый доступ, подписчики, публикации, категории, даты и статус РКН, когда он доступен |\n| Динамика аудитории | Дневные значения, минимум, максимум, абсолютный и процентный рост за выбранный период |\n| Просмотры и реакции | Суммарные, средние и максимальные значения на публикацию и дневная история |\n| Активность канала | Число публикаций, дневная история и распределение по тексту, фото, видео, файлам и другим форматам |\n| Поиск публикаций | Полнотекстовый поиск с фильтрами по каналу, формату, датам, просмотрам и реакциям |\n| Карточка публикации | Текст, URL, тип, вложения, просмотры, сумма и разбивка реакций, даты и источник пересылки |\n| История публикации | Дневные значения просмотров и реакций |\n| Пересылки | Найденные репосты, их URL, даты и ID каналов назначения |\n| Мониторинг | Webhook на новые публикации канала или новые публикации по ключевому слову и категории |\n| Тариф и расход | Статус тарифа, период, включённые, купленные, использованные и оставшиеся кредиты и история списаний |\n\nТакже можно добавить публичный или доступный по приглашению канал MAX в очередь\nотслеживания MaxStat.\n\n### Проверенный масштаб индекса\n\n| Проверено 29 июля 2026 года | Живой индекс |\n| --------------------------- | -------------: |\n| Каналы MAX | **408 501** |\n| Публикации | **86 315 758** |\n| Категории каналов | **42** |\n| MCP-инструменты | **21** |\n\nЭто показатели production на `maxstat.ru`, а не staging-окружения. Индекс\nпостоянно растёт. Используйте `search_channels`, `search_posts` и\n`get_categories`, чтобы получить актуальные результаты.\n\n### Быстрый старт\n\n1. Создайте токен в\n [личном кабинете MaxStat API](https://maxstat.ru/dashboard/api).\n2. Не публикуйте токен и не добавляйте его в Git.\n3. Выберите платформу ниже.\n4. Перезапустите клиент и проверьте, что доступны 21 инструмент MaxStat.\n\n| Параметр | Значение |\n| -------------------- | ---------------------------- |\n| Endpoint | `https://maxstat.ru/api/mcp` |\n| Транспорт | Streamable HTTP |\n| Авторизация | API-токен |\n| Заголовок | `X-API-Token: ` |\n| Переменная окружения | `MAXSTAT_API_TOKEN` |\n\n### Установка по платформам\n\n| Платформа | Способ |\n| ----------------------- | ------------------------------------------------------- |\n| Codex / ChatGPT desktop | Репозиторий-маркетплейс и нативный Codex-плагин |\n| Claude Code | Claude-compatible marketplace |\n| VS Code | Agent Plugins marketplace или прямой `.vscode/mcp.json` |\n| GitHub Copilot CLI | Общий Claude/Copilot marketplace |\n| Gemini CLI | Gemini extension с защищённой настройкой токена |\n| Cursor | Установка по ссылке или `~/.cursor/mcp.json` |\n| Windsurf | `~/.codeium/windsurf/mcp_config.json` |\n| JetBrains AI Assistant | MCP-настройки IDE |\n| Claude Desktop | Локальный мост `mcp-remote` |\n| Cline | Удалённый Streamable HTTP из `llms-install.md` |\n| Другие клиенты | Универсальный Streamable HTTP JSON |\n\n#### Codex\n\nДо запуска Codex сохраните токен в окружении:\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\n```\n\nДобавьте marketplace и установите плагин:\n\n```bash\ncodex plugin marketplace add fbmdata/maxstat-mcp\ncodex plugin add maxstat@maxstat-plugins\n```\n\nПлагин подключает MCP с правильным пользовательским заголовком\n`X-API-Token`. Не используйте Bearer-настройку: она отправляет другой заголовок\nи не подходит для MaxStat.\n\nДля прямой установки без плагина объедините\n[`configs/codex.toml`](configs/codex.toml) со своим\n`~/.codex/config.toml`:\n\n```toml\n[mcp_servers.maxstat]\nurl = \"https://maxstat.ru/api/mcp\"\nenv_http_headers = { \"X-API-Token\" = \"MAXSTAT_API_TOKEN\" }\n```\n\n#### Claude Code\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\nclaude plugin marketplace add fbmdata/maxstat-mcp\nclaude plugin install maxstat@maxstat-plugins\n```\n\nПрямая конфигурация находится в\n[`configs/claude-code.json`](configs/claude-code.json).\n\n#### Visual Studio Code\n\nДобавьте marketplace в `settings.json`:\n\n```json\n{\n \"chat.plugins.marketplaces\": [\"fbmdata/maxstat-mcp\"]\n}\n```\n\nОткройте Extensions, найдите `@agentPlugins`, выберите `MaxStat MCP` и нажмите\nInstall. Для прямого подключения скопируйте\n[`configs/vscode.json`](configs/vscode.json) в `.vscode/mcp.json`: VS Code\nбезопасно запросит токен через password input.\n\n#### GitHub Copilot CLI\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\ncopilot plugin marketplace add fbmdata/maxstat-mcp\ncopilot plugin install maxstat@maxstat-plugins\n```\n\nClaude Code, VS Code и GitHub Copilot CLI используют один совместимый плагин,\nskill и MCP-конфигурацию.\n\n#### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/fbmdata/maxstat-mcp\n```\n\nРасширение запросит `MAXSTAT_API_TOKEN` как чувствительную настройку и подключит\nего к заголовку `X-API-Token`. Инструкции Gemini находятся в\n[`GEMINI.md`](GEMINI.md).\n\n#### Cursor\n\n[![Add MaxStat MCP to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=maxstat&config=eyJ1cmwiOiJodHRwczovL21heHN0YXQucnUvYXBpL21jcCIsImhlYWRlcnMiOnsiWC1BUEktVG9rZW4iOiIke2VudjpNQVhTVEFUX0FQSV9UT0tFTn0ifX0%3D)\n\nПеред запуском Cursor задайте `MAXSTAT_API_TOKEN`, затем нажмите кнопку выше.\nАльтернатива: объедините\n[`configs/cursor.json`](configs/cursor.json) с `~/.cursor/mcp.json`.\n\n#### Cline\n\nЗадайте `MAXSTAT_API_TOKEN` до запуска Cline и передайте агенту\n[`llms-install.md`](llms-install.md). Файл содержит конфигурацию удалённого\nStreamable HTTP-сервера и проверку подключения. Локальный npm-пакет не нужен:\nMaxStat размещает и обслуживает сервер на `https://maxstat.ru/api/mcp`.\n\n#### Windsurf\n\nЗадайте `MAXSTAT_API_TOKEN` до запуска Windsurf и объедините\n[`configs/windsurf.json`](configs/windsurf.json) с\n`~/.codeium/windsurf/mcp_config.json`. Конфигурация использует нативную\nподстановку `${env:MAXSTAT_API_TOKEN}`.\n\n#### JetBrains AI Assistant\n\nОткройте **Settings → Tools → AI Assistant → Model Context Protocol (MCP)**,\nдобавьте HTTP-конфигурацию из\n[`configs/jetbrains.json`](configs/jetbrains.json) и замените ``\nлокально в IDE. JetBrains пока не документирует подстановку переменной\nокружения в MCP headers, поэтому placeholder оставлен намеренно.\n\n#### Claude Desktop\n\nОблачный custom connector Claude не принимает произвольный пользовательский\n`X-API-Token`. До внедрения OAuth 2.1 используйте локальный мост из\n[`configs/claude-desktop.json`](configs/claude-desktop.json). Требуются\nNode.js и npm; токен сохраняется только в локальной конфигурации Claude\nDesktop.\n\n#### Универсальная конфигурация\n\nИспользуйте [`configs/generic-mcp.json`](configs/generic-mcp.json):\n\n```json\n{\n \"mcpServers\": {\n \"maxstat\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://maxstat.ru/api/mcp\",\n \"headers\": {\n \"X-API-Token\": \"\"\n }\n }\n }\n}\n```\n\n### Все 21 инструмент\n\n#### Поиск и каталог\n\n| Инструмент | Что возвращает или делает | Кредиты |\n| ----------------- | ---------------------------------------------------------------- | --------: |\n| `get_categories` | Категории и актуальное количество каналов в каждой категории | Бесплатно |\n| `search_channels` | Отфильтрованные, отсортированные и постраничные карточки каналов | 3 |\n| `get_channel` | Полная карточка одного канала по идентификатору | 1 |\n| `add_channel` | Добавляет публичный или invite-only канал в очередь | Бесплатно |\n| `search_posts` | Отфильтрованные, отсортированные и постраничные публикации | 3 |\n\n#### Аналитика каналов\n\n| Инструмент | Что возвращает | Кредиты |\n| ------------------------- | ----------------------------------------------------------------- | ------: |\n| `get_channel_subscribers` | Минимум, максимум, абсолютный и процентный рост и дневную историю | 5 |\n| `get_channel_views` | Суммарные, средние и максимальные просмотры и дневную историю | 5 |\n| `get_channel_likes` | Суммарные, средние и максимальные реакции и дневную историю | 5 |\n| `get_channel_posts` | Число публикаций, форматы и дневную историю активности | 5 |\n\n#### Аналитика публикаций\n\n| Инструмент | Что возвращает | Кредиты |\n| ---------------- | ------------------------------------------------------------------ | ------: |\n| `get_post` | Контент, вложения, метрики, источник пересылки и найденные репосты | 1 |\n| `get_post_views` | Текущее число просмотров и дневную историю | 5 |\n| `get_post_likes` | Общее число реакций, разбивку по типам и дневную историю | 5 |\n\n#### Webhook-мониторинг\n\n| Инструмент | Что возвращает или делает | Кредиты |\n| ----------------------------- | --------------------------------------------------------------- | --------------------------------: |\n| `create_channel_subscription` | Подписывает публичный HTTPS callback на новые публикации канала | Создание бесплатно; 2 за доставку |\n| `create_keyword_subscription` | Подписывает callback на публикации по запросу и категории | Создание бесплатно; 3 за доставку |\n| `get_subscriptions` | Список подписок с фильтрами по статусу и типу | Бесплатно |\n| `get_subscription` | Одна подписка, состояние доставки и последняя ошибка | Бесплатно |\n| `update_subscription` | Изменение callback URL, пауза или возобновление | Бесплатно |\n| `delete_subscription` | Удаление webhook-подписки | Бесплатно |\n\nWebhook должен быть доступен по публичному HTTPS-адресу.\n\n#### Тариф и использование\n\n| Инструмент | Что возвращает | Кредиты |\n| -------------------------- | ---------------------------------------------------------- | --------: |\n| `get_account_subscription` | Тариф, статус, период и состояние кредитов | Бесплатно |\n| `get_account_limits` | Включённые, купленные, использованные и оставшиеся кредиты | Бесплатно |\n| `get_account_usage` | Постраничную историю списаний по запросам | Бесплатно |\n\n### Пример на реальных данных\n\nПроверочный запрос к production 29 июля 2026 года вернул:\n\n- канал **MAX • Анонсы** с аудиторией 3 496 789 подписчиков;\n- рост с 3 054 001 до 3 496 789 с 30 июня по 29 июля:\n **+442 788 / +14,5%**;\n- [публикацию](https://max.ru/max_news/AZ70lsF7P0s) с\n **17 888 688 просмотрами** и **187 460 реакциями**;\n- разбивку реакций, дневные истории просмотров и реакций;\n- 184 найденных пересылки.\n\nЗначения показывают структуру реального ответа и не являются обещанием\nфиксированных показателей продукта.\n\n### Примеры запросов\n\n```text\nНайди 20 технологических каналов MAX с максимальным приростом подписчиков за\nпоследние 30 дней. Верни ссылки, текущую аудиторию и процент роста.\n```\n\n```text\nСравни пять каналов по аудитории, средним просмотрам, реакциям, частоте\nпубликаций и распределению форматов.\n```\n\n```text\nНайди публикации об ипотеке за июль. Верни ссылки, текст, вложения, просмотры,\nдетальные реакции и найденные пересылки.\n```\n\n```text\nПодпиши webhook на новые публикации со словами «искусственный интеллект» в\nкатегории «Технологии».\n```\n\n```text\nПокажи мой тариф MaxStat, остаток кредитов и десять последних списаний.\n```\n\n### Тарифы и безопасность\n\nMCP входит во все [тарифы MaxStat API](https://maxstat.ru/promo/api) без\nдополнительной оплаты. MCP и прямые вызовы API используют единый баланс\nкредитов. Test Drive активируется при первом API-запросе и предоставляет\n1 000 кредитов каждые 30 дней.\n\nНикогда не публикуйте настоящий API-токен в issue, PR, конфигурации, логе или\nскриншоте. Об уязвимостях сообщайте по инструкции из\n[`SECURITY.md`](SECURITY.md).\n\n## English\n\nMaxStat MCP gives AI agents structured access to the live MAX messenger channel\nand publication index. It supports channel and post discovery, daily audience,\nview and reaction histories, publishing activity, attachment and reaction\ndetails, forward detection, webhook monitoring, and account credit usage.\nThe production index was verified on July 29, 2026 with 408,501 channels,\n86,315,758 posts, 42 channel categories, and 21 MCP tools.\n\n### Connection\n\n| Parameter | Value |\n| --------------- | ------------------------------------------------------------ |\n| Endpoint | `https://maxstat.ru/api/mcp` |\n| Transport | Streamable HTTP |\n| Header | `X-API-Token: ` |\n| Token dashboard | [maxstat.ru/dashboard/api](https://maxstat.ru/dashboard/api) |\n\n### Install\n\n#### Codex\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\ncodex plugin marketplace add fbmdata/maxstat-mcp\ncodex plugin add maxstat@maxstat-plugins\n```\n\n#### Claude Code\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\nclaude plugin marketplace add fbmdata/maxstat-mcp\nclaude plugin install maxstat@maxstat-plugins\n```\n\n#### GitHub Copilot CLI\n\n```bash\nexport MAXSTAT_API_TOKEN=\"\"\ncopilot plugin marketplace add fbmdata/maxstat-mcp\ncopilot plugin install maxstat@maxstat-plugins\n```\n\n#### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/fbmdata/maxstat-mcp\n```\n\nFor VS Code, Cursor, Windsurf, JetBrains AI Assistant, Claude Desktop, and\ngeneric clients, use the checked-in [`configs/`](configs/) directory. The\nRussian section above contains detailed client-specific instructions.\n\n### Capabilities\n\n- Search and filter MAX channels and publications.\n- Retrieve channel profiles, audience growth, views, reactions, activity, and\n content-format mix.\n- Retrieve post text, attachments, metrics, reaction details, histories, and\n detected forwards.\n- Create and manage channel or keyword webhook subscriptions.\n- Inspect the active MaxStat plan, credit balance, and request-level usage.\n\nThe complete 21-tool contract and credit costs are documented in\n[Все 21 инструмент](#все-21-инструмент).\n\n### Authentication boundary\n\nThis release supports clients that can send the custom `X-API-Token` header.\nPublishing as a fully hosted ChatGPT or Claude cloud connector requires a\nseparate OAuth 2.1 implementation.\n\n## Ссылки / Links\n\n- [MaxStat MCP](https://maxstat.ru/promo/mcp)\n- [Получить API-токен / Get a token](https://maxstat.ru/dashboard/api)\n- [Документация API / API documentation](https://maxstat.ru/api/docs)\n- [Тарифы API / API plans](https://maxstat.ru/promo/api)\n- [ООО «ФБМ Аналитикс» / FBM Analytics](https://fbmdata.ru)\n- [MaxStat Insights в MAX](https://max.ru/maxstat)\n- [FBM API Insights в Telegram](https://t.me/fbmapi)\n\n## Лицензия / License\n\nMIT распространяется только на опубликованные в этом репозитории манифесты,\nплагины, skill, конфигурации, документацию и вспомогательные проверки. Лицензия\nне распространяется на сервис MaxStat, API, данные, базы данных, товарные знаки\nи серверную реализацию. Подробности приведены в [`NOTICE`](NOTICE).\n", "bytes": 18593, "sha": "22070a8629d361a8a42792a931a3aded8add33b3be05c08b7d6750c2c85be95a", "repo_slug": "fbmdata/maxstat-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_fbmdata_maxstat_mcp_60ff4387/readme" }