Skip to main content
Glama
roistat-mcp

roistat-mcp

by theYahia

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

Разработка переехала в 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 проекта.

npm License: MIT

Related MCP server: calltouch-mcp

Установка

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


Telegram: @vhodvai

Available Tools

6 tools
get_analyticsC

Получение аналитики Roistat по источникам трафика за период. Метрики: визиты, заявки, выручка, ROI.

Inputs: to (required), from (required), limit, metrics, +1 more.

get_channelsB

Эффективность рекламных каналов: визиты, заявки, выручка, затраты, ROI по каждому каналу.

Inputs: to (required), from (required), metrics.

get_costsB

Затраты на рекламу по каналам с группировкой по дням/неделям/месяцам.

Inputs: to (required), from (required), group_by.

get_integrationsB

Список подключённых интеграций проекта Roistat (CRM, аналитика, рекламные кабинеты).

Inputs: no named parameters.

get_leadsA

Получение списка лидов (заявок) из Roistat за период с фильтрацией по статусам.

Inputs: to (required), from (required), limit, offset, +1 more.

get_visitsA

Список визитов на сайт из Roistat за период с источниками и UTM-метками.

Inputs: to (required), from (required), limit, offset, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool targets a distinct data type: analytics summary, visits, leads, channels, costs, and integrations. No overlap in purpose.

    Naming Consistency5/5

    All tools follow the consistent pattern of 'get_' + noun (e.g., get_analytics, get_visits). No deviations.

    Tool Count5/5

    6 tools is well-scoped for a marketing analytics server, covering core reporting needs without excess.

    Completeness4/5

    Covers all major read operations for Roistat data (analytics, visits, leads, channels, costs, integrations). Lacks write operations but that aligns with typical analytics use cases.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      MCP server for integrating with Roistat marketing analytics platform, enabling AI agents to analyze statistics, manage leads, track calls and channels.
      -
    • A
      license
      B
      quality
      F
      maintenance
      MCP server for Calltouch API to retrieve calls, leads, sources, tags, and statistics, enabling call tracking and analysis.
      7
      52 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for RedTrack affiliate tracking API, enabling querying campaigns, clicks, conversions, and reports from any MCP-compatible client.
      76 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that connects AI clients to RoASr ad-analytics for Meta, Google Ads, and Yandex Direct, enabling ad audit findings, KPI summaries, competitor creative spy, and Vision creative analysis. Read-only except for a Yandex Direct campaign pause/resume tool, scoped by API key permissions.
      18
      MIT