🗄 Репозиторий заархивирован

Разработка переехала в theYahia/WWmcp — монорепозиторий MCP-серверов для незападных API: СНГ, MENA, Африка, LATAM, Юго-Восточная Азия. Общее ядро @theyahia/mcp-core, единый CI, единый релизный конвейер.

Актуальная версия того, что лежало здесь: servers/roistat/

Пакет в npm прежний — @theyahia/roistat-mcp, ставится и работает как раньше. Здесь больше ничего не обновляется. Задачи и pull request'ы — в WWmcp.

Archived — development moved to theYahia/WWmcp, a monorepo of MCP servers for non-Western APIs. The current version of this package now lives at servers/roistat/. The npm package @theyahia/roistat-mcp is unchanged. Please open issues and pull requests there.

Roistat MCP — сквозная аналитика и стоимость лида в диалоге с нейросетью

Если вы искали, как спросить у ИИ, сколько стоит лид с каждого канала, свести расходы на рекламу с продажами или выгрузить лиды Roistat без ручных отчётов — это оно. 6 инструментов поверх API Roistat: лиды, рекламные каналы, затраты, аналитика и интеграции. Требуется API-ключ и ID проекта.

Установка

Claude Desktop

config.json

{
  "mcpServers": {
    "roistat": {
      "command": "npx",
      "args": ["-y", "@theyahia/roistat-mcp"],
      "env": {
        "ROISTAT_API_KEY": "ваш_ключ",
        "ROISTAT_PROJECT_ID": "ваш_id_проекта"
      }
    }
  }
}

Claude Code

Terminal

claude mcp add roistat \
  -e ROISTAT_API_KEY=ваш_ключ \
  -e ROISTAT_PROJECT_ID=ваш_id_проекта \
  -- npx -y @theyahia/roistat-mcp

Streamable HTTP

Terminal

npx @theyahia/roistat-mcp --http --port 3000
# POST /mcp — MCP endpoint
# GET  /health — health check

Smithery

Конфиг в smithery.yaml. Требуемые параметры: ROISTAT_API_KEY, ROISTAT_PROJECT_ID.

Авторизация

Переменная	Обязательна	Описание
`ROISTAT_API_KEY`	Да	API-ключ проекта Roistat
`ROISTAT_PROJECT_ID`	Да	ID проекта в Roistat

Base URL: https://cloud.roistat.com/api/v1/

Инструменты (6)

Инструмент	Описание
`get_analytics`	Аналитика: визиты, заявки, выручка, ROI по источникам
`get_visits`	Список визитов с источниками и UTM-метками
`get_leads`	Лиды (заявки) с фильтрацией по статусам
`get_channels`	Эффективность рекламных каналов: ROI, CPL, выручка
`get_costs`	Затраты на рекламу с группировкой по периодам
`get_integrations`	Список подключённых интеграций (CRM, аналитика)

Скиллы (Prompts)

Скилл	Описание
`skill-analytics`	Аналитика за период — сводка по ключевым метрикам с топ-3 источниками
`skill-channels`	Эффективность рекламных каналов — сравнение ROI, рекомендации по бюджету

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

Code

Какой ROI у рекламных каналов за последний месяц?
Покажи визиты за сегодня
Сколько лидов пришло за неделю?
Какие интеграции подключены?
Сравни затраты по каналам за март

Реферальная программа Roistat

Тип	Комиссия
Юридические лица	25% от оплат клиента
ИП	50% от оплат клиента

Подробнее: roistat.com/referral

Разработка

Terminal

npm install
npm test          # Vitest
npm run dev       # stdio (tsx)
npm run start:http  # HTTP-сервер

Лицензия

MIT

Telegram: @vhodvai