Roistat Mcp

io.github.theYahiaPublished by GitHub account theYahiav1.0.1Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

MCP server for the Roistat marketing analytics API, letting an assistant pull leads, ad channel ROI, costs, visits and integrations.

What you can do
  • Retrieve analytics on visits, leads, revenue and ROI by source
  • List visits with sources and UTM tags
  • Fetch leads filtered by status
  • Compare ad channel performance (ROI, CPL, revenue) and ad costs grouped by period
  • List connected CRM and analytics integrations
  • Run built-in prompts for a period summary or channel comparison
When to use it
Useful when you want to ask an assistant about lead cost per channel, reconcile ad spend with sales, or export Roistat leads and channel metrics without building reports by hand.
Requirements
Runs locally via npx from the npm package @theyahia/roistat-mcp (Node.js). Needs a Roistat API key in ROISTAT_API_KEY and a project ID in ROISTAT_PROJECT_ID. Network access to the Roistat cloud API. Can also be started as a Streamable HTTP server on a chosen port.
Before you install
Requires a Roistat API key (ROISTAT_API_KEY) and project ID; the key grants access to your project's marketing data. The repository is archived and development moved to another monorepo, though the npm package is said to be unchanged. The README also contains a Roistat referral program section unrelated to the server's function.

Installation

In SourceWeft

  1. Open Roistat Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

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

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

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

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

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

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

Разработка

bash
npm installnpm test          # Vitestnpm run dev       # stdio (tsx)npm run start:http  # HTTP-сервер

Лицензия

MIT

Telegram: @vhodvai

Source: README.md at commit 403be06

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts