clevertap-mcp

Un servidor del Protocolo de Contexto de Modelo (MCP) para la API REST de CleverTap. Expone los perfiles de usuario, eventos, campañas e informes de CleverTap como herramientas que cualquier asistente de IA compatible con MCP (Claude, Cursor, etc.) puede invocar directamente.

Características

Multiproyecto — gestiona múltiples cuentas de CleverTap desde una única instancia de servidor
Configuración guiada — si no hay ningún proyecto configurado, clevertap_configure te guía a través del proceso
Cobertura total de la API — eventos, perfiles, campañas e informes
Sondeo asíncrono — las operaciones de larga duración (recuentos de eventos/perfiles) se sondean automáticamente

Herramientas

Eventos

Herramienta	Descripción
`clevertap_upload_events`	Subir uno o más eventos para un usuario
`clevertap_get_events`	Consultar datos de eventos con filtros
`clevertap_get_events_cursor`	Obtener la siguiente página de resultados de eventos mediante un cursor
`clevertap_get_event_count`	Obtener el recuento total de un evento (con sondeo asíncrono)

Perfiles

Herramienta	Descripción
`clevertap_upload_profiles`	Crear o actualizar perfiles de usuario
`clevertap_get_profile`	Buscar un usuario único por identidad, correo electrónico u objectId
`clevertap_get_profiles_by_event`	Obtener perfiles de usuarios que realizaron un evento
`clevertap_get_profiles_cursor`	Obtener la siguiente página de resultados de perfiles mediante un cursor
`clevertap_delete_profile`	Eliminar un perfil de usuario
`clevertap_upload_device_token`	Registrar un token de push para un usuario
`clevertap_get_profile_count`	Contar perfiles que coinciden con un segmento
`clevertap_demerge_profiles`	Separar perfiles fusionados
`clevertap_subscribe`	Suscribir/cancelar la suscripción de un usuario a canales
`clevertap_disassociate_phone`	Eliminar un número de teléfono de un perfil

Campañas

Herramienta	Descripción
`clevertap_get_campaigns`	Listar campañas dentro de un rango de fechas
`clevertap_get_campaign_report`	Obtener estadísticas de entrega y participación de una campaña
`clevertap_stop_campaign`	Detener una campaña en ejecución
`clevertap_create_campaign`	Crear y lanzar una campaña

Informes

Herramienta	Descripción
`clevertap_get_message_report`	Informe de entrega a nivel de mensaje
`clevertap_get_top_property_count`	Recuentos de valores de propiedad principales para un evento
`clevertap_get_event_trend`	Tendencia diaria/semanal/mensual de un evento
`clevertap_get_dau`	Tendencia de usuarios activos diarios
`clevertap_get_uninstall_report`	Informe de tendencia de desinstalaciones
`clevertap_get_real_time_counts`	Recuentos de usuarios activos en tiempo real

Genérico

Herramienta	Descripción
`clevertap_request`	Realizar cualquier solicitud de API REST sin procesar
`clevertap_poll`	Sondear una solicitud asíncrona pendiente mediante `req_id`

Web / Navegador

Herramienta	Descripción
`clevertap_web_login`	Abrir una ventana de Chromium y capturar la cookie de sesión del panel + token CSRF después del inicio de sesión manual (admite SSO y 2FA)
`clevertap_web_session_status`	Comprobar si se ha capturado una sesión web para un proyecto y cuándo se obtuvo
`clevertap_web_request`	Realizar una solicitud autenticada a cualquier endpoint del panel de CleverTap utilizando la sesión capturada
`clevertap_get_campaigns_ui`	Listar campañas desde la API de la interfaz del panel: datos más completos que la API REST (estado, enviados, impresiones, clics, URL de edición)
`clevertap_send_test_push`	Enviar una notificación push de prueba a un token de dispositivo específico. Acepta el token push de `clevertap_get_profile` (`platformInfo[].push_token`), la plataforma de destino (`ios`/`android`), el nombre del canal push y una URL de enlace profundo opcional.

Requisito previo para las herramientas web: instalar el binario de Playwright Chromium una vez después de npm install:
npx playwright install chromium

Instalación

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

Configuración

El servidor lee las credenciales del proyecto desde la variable de entorno CLEVERTAP_PROJECTS: una matriz JSON de objetos de proyecto:

[
  {
    "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"
  }
]

Regiones admitidas: in1, us1, eu1, sg1, aps3, mec1

Alternativa para un solo proyecto

También puedes usar variables de entorno individuales para un solo proyecto:

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

Añadir a Claude Desktop

En tu claude_desktop_config.json (o ~/.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\"}]"
      }
    }
  }
}

Importante: CLEVERTAP_PROJECTS debe ser una cadena JSON serializada (no un objeto JSON nativo) dentro del bloque env.

Desarrollo

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

Estructura del proyecto

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)

Licencia

MIT

clevertap-mcp

clevertap-mcp

Características

Herramientas

Meta

Eventos

Perfiles

Campañas

Informes

Genérico

Web / Navegador

Instalación

Configuración

Alternativa para un solo proyecto

Añadir a Claude Desktop

Desarrollo

Estructura del proyecto

Licencia

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API

Herramienta	Descripción
`clevertap_configure`	Configuración guiada para añadir un proyecto o generar la configuración `CLEVERTAP_PROJECTS`
`clevertap_list_projects`	Listar todos los proyectos configurados y sus regiones