Skip to main content
Glama
LuCheremisina

Roistat MCP Server

Roistat MCP Server

MCP (Model Context Protocol) server for integration with the Roistat marketing analytics platform. It allows AI agents (Claude, GPT, etc.) to work directly with Roistat data: analyze statistics, manage leads, track calls, and monitor channels.


Capabilities

📊 Analytics

Tool

Description

roistat_get_statistics

Marketing statistics: visits, leads, ROI, CPL by channels/campaigns

roistat_get_report

Flexible report grouped by days/weeks/months

🎯 Leads and Applications

Tool

Description

roistat_list_leads

List of leads with filtering by date, status

roistat_get_lead

Detailed information about a specific lead

roistat_update_lead

Update status, revenue, and lead fields

roistat_create_lead

Create a new lead (offline conversions)

📞 Call Tracking

Tool

Description

roistat_list_calls

Call history with filtering

roistat_get_call

Call details: source, recording, duration

roistat_list_phones

List of tracking numbers

📡 Advertising Channels

Tool

Description

roistat_list_channels

All marketing channels of the project

roistat_get_channel_costs

Costs by channel for a period

roistat_set_channel_costs

Manual cost upload (offline channels)

⚙️ Project

Tool

Description

roistat_get_project_info

Project information, settings, integrations

roistat_list_events

Conversion events

roistat_send_event

Manually send a conversion event

roistat_get_billing

Plan, balance, usage statistics

roistat_get_mediaplan

Media plan: plan vs actual by channel


Installation

Requirements

  • Node.js 18+

  • npm or yarn

  • Roistat account with API access

Steps

git clone <repo-url>
cd roistat-mcp-server
npm install
npm run build

Environment Variables

# Обязательные
ROISTAT_API_KEY=ваш_api_ключ        # Профиль → API-ключ
ROISTAT_PROJECT_ID=12345            # Номер проекта (из URL или настроек)

# Опциональные
TRANSPORT=stdio                     # или "http" для удалённого сервера
PORT=3000                           # только при TRANSPORT=http

Where to find the API key: Roistat → Settings → API-key → Copy


Running

stdio (locally, for Claude Desktop / Claude Code)

ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

HTTP (remote deployment, VPS/Docker)

TRANSPORT=http PORT=3000 ROISTAT_API_KEY=xxx ROISTAT_PROJECT_ID=12345 node dist/index.js

Claude Desktop Configuration

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "roistat": {
      "command": "node",
      "args": ["/path/to/roistat-mcp-server/dist/index.js"],
      "env": {
        "ROISTAT_API_KEY": "ваш_api_ключ",
        "ROISTAT_PROJECT_ID": "12345"
      }
    }
  }
}

Configuration for HTTP (OpenClaw / remote MCP)

{
  "mcpServers": {
    "roistat": {
      "url": "http://your-vps-ip:3000/mcp",
      "type": "streamable-http"
    }
  }
}

Docker Deployment (for Hostinger VPS)

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY dist/ ./dist/
EXPOSE 3000
ENV TRANSPORT=http
CMD ["node", "dist/index.js"]
docker build -t roistat-mcp .
docker run -d -p 3000:3000 \
  -e ROISTAT_API_KEY=xxx \
  -e ROISTAT_PROJECT_ID=12345 \
  roistat-mcp

Examples of prompts for Claude

After connecting the MCP, ask Claude:

  • "Show me the ROI by channel for the last 30 days"

  • "How many leads came from Yandex.Direct in March?"

  • "Find all missed calls from yesterday and create tasks for them"

  • "Upload costs for the offline channel of 500 rubles for today"

  • "Compare CPL of April with March across all channels"

  • "Update the status of lead #12345 to 'Paid', revenue 15000 RUB"


Project Structure

roistat-mcp-server/
├── src/
│   ├── index.ts              # Точка входа, инициализация сервера
│   ├── services/
│   │   └── roistat-client.ts # HTTP-клиент для Roistat API
│   └── tools/
│       ├── analytics.ts      # Статистика и отчёты
│       ├── leads.ts          # Лиды и заявки
│       ├── calltracking.ts   # Коллтрекинг
│       ├── channels.ts       # Каналы и расходы
│       └── project.ts        # Проект, события, биллинг
├── dist/                     # Скомпилированные файлы
├── package.json
└── tsconfig.json

License

MIT

F
license - not found
Not graded
quality - not tested
C
maintenance

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

  • Hosted MCP server for the Wavix telecom platform: SMS, voice, 2FA, SIP, numbers, 10DLC, CDRs.

  • MCP server for LeadDelta — manage LinkedIn connections and CRM data via AI assistants.

  • Official MCP server for OmniDimension. Drive voice agents, dispatch calls, and run bulk campaigns.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/LuCheremisina/Roistat_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server