roistat-mcp
This server provides Roistat marketing analytics tools to query traffic, leads, revenue, costs, and integrations.
get_analytics: Fetch aggregate metrics (visits, leads, revenue, ROI) by dimensions like source for a date range.
get_visits: Retrieve detailed visit lists with source and UTM parameters, supporting pagination and source filtering.
get_leads: Get lead (request) lists filtered by status, with pagination.
get_channels: Compare advertising channel performance (visits, leads, revenue, cost, ROI).
get_costs: Get advertising costs grouped by day, week, or month.
get_integrations: List connected integrations (CRM, analytics, ad accounts).
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@roistat-mcp What were the top channels by ROI last month?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🗄 Репозиторий заархивирован
Разработка переехала в 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-mcpis unchanged. Please open issues and pull requests there.
Roistat MCP — сквозная аналитика и стоимость лида в диалоге с нейросетью
Если вы искали, как спросить у ИИ, сколько стоит лид с каждого канала, свести расходы на рекламу с продажами или выгрузить лиды Roistat без ручных отчётов — это оно. 6 инструментов поверх API Roistat: лиды, рекламные каналы, затраты, аналитика и интеграции. Требуется API-ключ и ID проекта.
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-mcpStreamable HTTP
npx @theyahia/roistat-mcp --http --port 3000
# POST /mcp — MCP endpoint
# GET /health — health checkSmithery
Конфиг в smithery.yaml. Требуемые параметры: ROISTAT_API_KEY, ROISTAT_PROJECT_ID.
Авторизация
Переменная | Обязательна | Описание |
| Да | API-ключ проекта Roistat |
| Да | ID проекта в Roistat |
Base URL: https://cloud.roistat.com/api/v1/
Инструменты (6)
Инструмент | Описание |
| Аналитика: визиты, заявки, выручка, ROI по источникам |
| Список визитов с источниками и UTM-метками |
| Лиды (заявки) с фильтрацией по статусам |
| Эффективность рекламных каналов: ROI, CPL, выручка |
| Затраты на рекламу с группировкой по периодам |
| Список подключённых интеграций (CRM, аналитика) |
Скиллы (Prompts)
Скилл | Описание |
| Аналитика за период — сводка по ключевым метрикам с топ-3 источниками |
| Эффективность рекламных каналов — сравнение 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 toolsget_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
Scored across 6 tools
Each tool targets a distinct data type: analytics summary, visits, leads, channels, costs, and integrations. No overlap in purpose.
All tools follow the consistent pattern of 'get_' + noun (e.g., get_analytics, get_visits). No deviations.
6 tools is well-scoped for a marketing analytics server, covering core reporting needs without excess.
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
MCP server for querying and analyzing data from ad platforms, analytics tools, and spreadsheets
Cookie-free web analytics MCP server: read stats, create UTM links, goals and ad costs.
Marketing intelligence MCP server providing campaign performance data and analytics tools.
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceMCP server for integrating with Roistat marketing analytics platform, enabling AI agents to analyze statistics, manage leads, track calls and channels.-
- AlicenseBqualityFmaintenanceMCP server for Calltouch API to retrieve calls, leads, sources, tags, and statistics, enabling call tracking and analysis.752 npmMIT
- AlicenseNot gradedqualityBmaintenanceMCP server for RedTrack affiliate tracking API, enabling querying campaigns, clicks, conversions, and reports from any MCP-compatible client.76 npm1MIT
- AlicenseAqualityDmaintenanceMCP 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.18MIT