io.github.theYahia/roistat-mcp

Official

by theYahia · TypeScript

MCP server for Roistat API — marketing analytics, visits tracking. API key auth.

Track marketing analytics and visitor data through Roistat API.

Topics

aiclaudellmmcpmcp-servermodel-context-protocolroistatrussian-apitypescriptanalyticsapimarketing

README.md3 KBView on GitHub

@theyahia/roistat-mcp

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

Установка

Claude Desktop

json

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

Claude Code

bash

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

Streamable HTTP

bash

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

Разработка

bash

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

Лицензия

MIT

Install

Configuration

Environment variables

ROISTAT_API_KEYrequiredsecret

API key

claude_desktop_config.json

{
  "mcpServers": {
    "roistat-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/roistat-mcp@1.0.1"
      ],
      "env": {
        "ROISTAT_API_KEY": "<YOUR_ROISTAT_API_KEY>"
      }
    }
  }
}