@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

roistat-mcp

Quick Install