@theyahia/roistat-mcp

MCP-сервер для API Roistat — маркетинговая аналитика, лиды, рекламные каналы, затраты, интеграции. Требуется API-ключ и ID проекта.

Установка

Claude Desktop

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

Claude Code

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

Streamable HTTP

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, рекомендации по бюджету

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

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

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

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

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

Разработка

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

Лицензия

MIT