Skip to main content
Glama
Sign In
deenesjakoruzh
clevertap-mcp

clevertap-mcp

by ralphcorleone
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

clevertap-mcp

Сервер Model Context Protocol (MCP) для CleverTap REST API. Предоставляет профили пользователей, события, кампании и отчеты CleverTap в виде инструментов, которые может напрямую вызывать любой ИИ-ассистент с поддержкой MCP (Claude, Cursor и т. д.).

Функции

  • Мультипроектность — управление несколькими аккаунтами CleverTap из одного экземпляра сервера

  • Пошаговая настройка — если проект не настроен, clevertap_configure поможет вам пройти этот процесс

  • Полное покрытие API — события, профили, кампании и отчеты

  • Асинхронный опрос — длительные операции (подсчет событий/профилей) опрашиваются автоматически

Related MCP server: Mixpanel MCP Server

Инструменты

Мета

Инструмент

Описание

clevertap_configure

Пошаговая настройка для добавления проекта или генерации конфигурации CLEVERTAP_PROJECTS

clevertap_list_projects

Список всех настроенных проектов и их регионов

События

Инструмент

Описание

clevertap_upload_events

Загрузка одного или нескольких событий для пользователя

clevertap_get_events

Запрос данных о событиях с фильтрами

clevertap_get_events_cursor

Получение следующей страницы результатов событий через курсор

clevertap_get_event_count

Получение общего количества событий (с асинхронным опросом)

Профили

Инструмент

Описание

clevertap_upload_profiles

Создание или обновление профилей пользователей

clevertap_get_profile

Поиск одного пользователя по идентификатору, email или objectId

clevertap_get_profiles_by_event

Получение профилей пользователей, совершивших событие

clevertap_get_profiles_cursor

Получение следующей страницы результатов профилей через курсор

clevertap_delete_profile

Удаление профиля пользователя

clevertap_upload_device_token

Регистрация push-токена для пользователя

clevertap_get_profile_count

Подсчет профилей, соответствующих сегменту

clevertap_demerge_profiles

Разделение объединенных профилей

clevertap_subscribe

Подписка/отписка пользователя от каналов

clevertap_disassociate_phone

Удаление номера телефона из профиля

Кампании

Инструмент

Описание

clevertap_get_campaigns

Список кампаний в заданном диапазоне дат

clevertap_get_campaign_report

Получение статистики доставки и вовлеченности для кампании

clevertap_stop_campaign

Остановка запущенной кампании

clevertap_create_campaign

Создание и запуск кампании

Отчеты

Инструмент

Описание

clevertap_get_message_report

Отчет о доставке на уровне сообщений

clevertap_get_top_property_count

Подсчет значений топ-свойств для события

clevertap_get_event_trend

Дневной/недельный/месячный тренд для события

clevertap_get_dau

Тренд ежедневных активных пользователей (DAU)

clevertap_get_uninstall_report

Отчет о тренде удалений приложения

clevertap_get_real_time_counts

Количество активных пользователей в реальном времени

Общие

Инструмент

Описание

clevertap_request

Выполнение любого произвольного запроса к REST API

clevertap_poll

Опрос ожидающего асинхронного запроса по req_id

Веб / Браузер

Инструмент

Описание

clevertap_web_login

Открытие окна Chromium и захват cookie сессии панели управления + CSRF-токена после ручного входа (поддерживает SSO и 2FA)

clevertap_web_session_status

Проверка, была ли захвачена веб-сессия для проекта и когда она была получена

clevertap_web_request

Выполнение аутентифицированного запроса к любому эндпоинту панели управления CleverTap с использованием захваченной сессии

clevertap_get_campaigns_ui

Список кампаний из API веб-интерфейса панели управления — более полные данные, чем в REST API (статус, отправлено, показы, клики, URL редактирования)

clevertap_send_test_push

Отправка тестового push-уведомления на конкретный токен устройства. Принимает push-токен из clevertap_get_profile (platformInfo[].push_token), целевую платформу (ios/android), имя push-канала и опциональный URL глубокой ссылки (deep link).

Предварительное требование для веб-инструментов: установите бинарный файл Playwright Chromium один раз после npm install:

npx playwright install chromium

Установка

git clone https://github.com/your-org/clevertap-mcp.git
cd clevertap-mcp
npm install
npx playwright install chromium   # required for web/browser tools
npm run build

Конфигурация

Сервер считывает учетные данные проекта из переменной окружения CLEVERTAP_PROJECTS — JSON-массива объектов проектов:

[
  {
    "name": "My App - Production",
    "account_id": "XXX-XXX-XXXX",
    "passcode": "YYY-YYY-YYYY",
    "region": "us1"
  },
  {
    "name": "My App - Staging",
    "account_id": "AAA-AAA-AAAA",
    "passcode": "BBB-BBB-BBBB",
    "region": "us1"
  }
]

Поддерживаемые регионы: in1, us1, eu1, sg1, aps3, mec1

Резервный вариант для одного проекта

Вы также можете использовать отдельные переменные окружения для одного проекта:

CLEVERTAP_ACCOUNT_ID=XXX-XXX-XXXX
CLEVERTAP_PASSCODE=YYY-YYY-YYYY
CLEVERTAP_REGION=us1

Добавление в Claude Desktop

В вашем файле claude_desktop_config.json (или ~/.claude.json):

{
  "mcpServers": {
    "clevertap": {
      "command": "node",
      "args": ["/absolute/path/to/clevertap-mcp/dist/index.js"],
      "env": {
        "CLEVERTAP_PROJECTS": "[{\"name\":\"My App\",\"account_id\":\"XXX-XXX-XXXX\",\"passcode\":\"YYY-YYY-YYYY\",\"region\":\"us1\"}]"
      }
    }
  }
}

Важно: CLEVERTAP_PROJECTS должен быть сериализованной JSON-строкой (не нативным JSON-объектом) внутри блока env.

Разработка

npm run build      # compile TypeScript → dist/
npm run dev        # watch mode
npm start          # run compiled server

Структура проекта

src/
  index.ts          # MCP server entry point, project config, tool registration
  client.ts         # CleverTap REST API HTTP client
  tools/
    events.ts       # Event upload and query tools
    profiles.ts     # Profile management tools
    campaigns.ts    # Campaign tools
    reports.ts      # Analytics and report tools
    generic.ts      # Raw request / poll tools
    web.ts          # Browser session tools via Playwright (login, campaigns UI, test push)

Лицензия

MIT

Available Tools

1 tool
clevertap_configureA

CleverTap MCP has no project configured yet. Call this tool with your CleverTap credentials and it will return the exact configuration snippet to paste into your MCP settings — then restart the server to activate all tools.

Inputs: account_id (required), passcode (required), region, project_name.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.1/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools, as there are no other tools to compare it to. The tool's purpose is clearly defined as a configuration setup step.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect. The tool name 'clevertap_configure' follows a clear verb_noun pattern, and there are no other tools to create inconsistency.

    Tool Count2/5

    A single tool is too few for a server intended to interact with CleverTap, as it suggests the server is not yet fully functional or lacks operational capabilities. This is a significant mismatch for the apparent scope of a CleverTap integration.

    Completeness1/5

    The tool set is severely incomplete for a CleverTap MCP server, as it only provides a configuration tool and no actual operational tools for interacting with CleverTap data or features. This leaves obvious gaps in the domain coverage.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers