MCP server for Roistat API — marketing analytics, visits tracking. API key auth.
Runs on your machine from its package; the steps are below.
At most: only reads or looks up information.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
npx -y @theyahia/roistat-mcp
MCP client config
{
"mcpServers": {
"roistat": {
"command": "npx",
"args": [
"-y",
"@theyahia/roistat-mcp"
]
}
}
}🗄 Репозиторий заархивирован
Разработка переехала в 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 без ручных отчётов — это оно. 6 инструментов поверх API Roistat: лиды, рекламные каналы, затраты, аналитика и интеграции. Требуется API-ключ и ID проекта.
{
"mcpServers": {
"roistat": {
"command": "npx",
"args": ["-y", "@theyahia/roistat-mcp"],
"env": {
"ROISTAT_API_KEY": "ваш_ключ",
"ROISTAT_PROJECT_ID": "ваш_id_проекта"
}
}
}
}
claude mcp add roistat \
-e ROISTAT_API_KEY=ваш_ключ \
-e ROISTAT_PROJECT_ID=ваш_id_проекта \
-- npx -y @theyahia/roistat-mcp
npx @theyahia/roistat-mcp --http --port 3000
# POST /mcp — MCP endpoint
# GET /health — health check
Конфиг в 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/
| Инструмент | Описание |
|---|---|
get_analytics | Аналитика: визиты, заявки, выручка, ROI по источникам |
get_visits | Список визитов с источниками и UTM-метками |
get_leads | Лиды (заявки) с фильтрацией по статусам |
get_channels | Эффективность рекламных каналов: ROI, CPL, выручка |
get_costs | Затраты на рекламу с группировкой по периодам |
get_integrations | Список подключённых интеграций (CRM, аналитика) |
| Скилл | Описание |
|---|---|
skill-analytics | Аналитика за период — сводка по ключевым метрикам с топ-3 источниками |
skill-channels | Эффективность рекламных каналов — сравнение ROI, рекомендации по бюджету |
Какой ROI у рекламных каналов за последний месяц?
Покажи визиты за сегодня
Сколько лидов пришло за неделю?
Какие интеграции подключены?
Сравни затраты по каналам за март
| Тип | Комиссия |
|---|---|
| Юридические лица | 25% от оплат клиента |
| ИП | 50% от оплат клиента |
Подробнее: roistat.com/referral
npm install
npm test # Vitest
npm run dev # stdio (tsx)
npm run start:http # HTTP-сервер
MIT
Telegram: @vhodvai