mcpField
R
roistat-mcp

roistat-mcp

Local
github.com/theYahiaData & Analytics0Updated 8w ago
Repository

About roistat-mcp

roistat-mcp is an MCP server for querying Roistat marketing analytics. It exposes data on leads, visits, channels, costs, and integrations; the repository is archived, with development moved to WWmcp.

Key features

  1. 01Query visits, leads, and revenue analytics
  2. 02View visits with sources and UTM tags
  3. 03Filter leads by status
  4. 04Analyze channel ROI, CPL, and revenue
  5. 05Group ad costs by period
  6. 06List connected integrations

Use cases

  1. 01Compare channel ROI over a chosen period
  2. 02Review visits and their sources for today
  3. 03Find leads by status
  4. 04Check advertising costs and connected integrations

MCP support

It exposes six Roistat API tools to MCP clients and requires an API key and project ID. It supports stdio and Streamable HTTP; development has moved to WWmcp.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "theyahia-roistat": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/roistat-mcp"
      ],
      "env": {
        "ROISTAT_API_KEY": "<ROISTAT_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @theyahia/roistat-mcp
Environment variables to set
ROISTAT_API_KEYSecretAPI key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@theyahia/roistat-mcp1.0.1

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
tostringYesPeriod end date (YYYY-MM-DD)
fromstringYesPeriod start date (YYYY-MM-DD)
limitnumberNoMaximum number of rows in the response
metricsarrayNoMetrics: visitCount, leadCount, orderCount, revenue, visits2leads, visits2orders, etc.
dimensionsarrayNoGrouping dimensions: marker (source), landing_page, region, keyword, etc.

Details

From the project README

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

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

Установка

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.