Meta Agent Tools
PT

Back to the catalog

io.github.theYahia/roistat-mcp

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
Marketing & analytics
Publisher
theyahia
Origin
official
Category
ferramentas
Transport
local
Version
1.0.1
Last push
2026-09-02T19:11:08Z
Repository state
ativo
Language
TypeScript
License
MIT
Added
2026-08-29 04:01:31
Updated
2026-08-29 04:01:31
Origin id
io.github.theYahia/roistat-mcp

README

# Roistat MCP — сквозная аналитика и стоимость лида в диалоге с нейросетью

Если вы искали, как спросить у ИИ, сколько стоит лид с каждого канала, свести расходы на рекламу с продажами или выгрузить лиды Roistat без ручных отчётов — это оно. 6 инструментов поверх API Roistat: лиды, рекламные каналы, затраты, аналитика и интеграции. Требуется API-ключ и ID проекта.

[![npm](https://img.shields.io/npm/v/@theyahia/roistat-mcp)](https://www.npmjs.com/package/@theyahia/roistat-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/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](https://roistat.com/referral/)

## Разработка

```bash
npm install
npm test          # Vitest
npm run dev       # stdio (tsx)
npm run start:http  # HTTP-сервер
```

## Лицензия

MIT

More