Skip to main content
Glama

clevertap-mcp

Ein Model Context Protocol (MCP)-Server für die CleverTap REST-API. Er stellt CleverTaps Benutzerprofile, Ereignisse, Kampagnen und Berichte als Tools bereit, die von jedem MCP-kompatiblen KI-Assistenten (Claude, Cursor usw.) direkt aufgerufen werden können.


Funktionen

  • Multi-Projekt — Verwalten Sie mehrere CleverTap-Konten über eine einzige Serverinstanz

  • Geführte Einrichtung — Wenn kein Projekt konfiguriert ist, führt Sie clevertap_configure durch den Prozess

  • Vollständige API-Abdeckung — Ereignisse, Profile, Kampagnen und Berichte

  • Asynchrones Polling — Lang laufende Vorgänge (Ereignis-/Profilzählungen) werden automatisch abgefragt


Related MCP server: Mixpanel MCP Server

Tools

Meta

Tool

Beschreibung

clevertap_configure

Geführte Einrichtung zum Hinzufügen eines Projekts oder zum Generieren der CLEVERTAP_PROJECTS-Konfiguration

clevertap_list_projects

Alle konfigurierten Projekte und deren Regionen auflisten

Ereignisse

Tool

Beschreibung

clevertap_upload_events

Ein oder mehrere Ereignisse für einen Benutzer hochladen

clevertap_get_events

Ereignisdaten mit Filtern abfragen

clevertap_get_events_cursor

Die nächste Seite der Ereignisergebnisse über einen Cursor abrufen

clevertap_get_event_count

Die Gesamtzahl eines Ereignisses abrufen (mit asynchronem Polling)

Profile

Tool

Beschreibung

clevertap_upload_profiles

Benutzerprofile erstellen oder aktualisieren

clevertap_get_profile

Einen einzelnen Benutzer anhand von Identität, E-Mail oder objectId suchen

clevertap_get_profiles_by_event

Profile von Benutzern abrufen, die ein Ereignis durchgeführt haben

clevertap_get_profiles_cursor

Die nächste Seite der Profilergebnisse über einen Cursor abrufen

clevertap_delete_profile

Ein Benutzerprofil löschen

clevertap_upload_device_token

Ein Push-Token für einen Benutzer registrieren

clevertap_get_profile_count

Profile zählen, die einem Segment entsprechen

clevertap_demerge_profiles

Zusammengeführte Profile trennen

clevertap_subscribe

Einen Benutzer für Kanäle abonnieren/abmelden

clevertap_disassociate_phone

Eine Telefonnummer aus einem Profil entfernen

Kampagnen

Tool

Beschreibung

clevertap_get_campaigns

Kampagnen innerhalb eines Datumsbereichs auflisten

clevertap_get_campaign_report

Zustellungs- und Interaktionsstatistiken für eine Kampagne abrufen

clevertap_stop_campaign

Eine laufende Kampagne stoppen

clevertap_create_campaign

Eine Kampagne erstellen und starten

Berichte

Tool

Beschreibung

clevertap_get_message_report

Zustellungsbericht auf Nachrichtenebene

clevertap_get_top_property_count

Zählungen der häufigsten Eigenschaftswerte für ein Ereignis

clevertap_get_event_trend

Täglicher/wöchentlicher/monatlicher Trend für ein Ereignis

clevertap_get_dau

Trend der täglich aktiven Benutzer

clevertap_get_uninstall_report

Deinstallationstrend-Bericht

clevertap_get_real_time_counts

Echtzeit-Zählungen aktiver Benutzer

Allgemein

Tool

Beschreibung

clevertap_request

Eine beliebige rohe REST-API-Anfrage stellen

clevertap_poll

Eine ausstehende asynchrone Anfrage per req_id abfragen

Web / Browser

Tool

Beschreibung

clevertap_web_login

Ein Chromium-Fenster öffnen und das Dashboard-Sitzungs-Cookie + CSRF-Token nach manuellem Login erfassen (unterstützt SSO und 2FA)

clevertap_web_session_status

Überprüfen, ob eine Websitzung für ein Projekt erfasst wurde und wann sie erhalten wurde

clevertap_web_request

Eine authentifizierte Anfrage an einen beliebigen CleverTap-Dashboard-Endpunkt unter Verwendung der erfassten Sitzung stellen

clevertap_get_campaigns_ui

Kampagnen über die Dashboard-UI-API auflisten — reichhaltigere Daten als die REST-API (Status, gesendet, Impressionen, Klicks, Bearbeitungs-URL)

clevertap_send_test_push

Eine Test-Push-Benachrichtigung an ein bestimmtes Geräte-Token senden. Akzeptiert das Push-Token von clevertap_get_profile (platformInfo[].push_token), die Zielplattform (ios/android), den Namen des Push-Kanals und eine optionale Deep-Link-URL.

Voraussetzung für Web-Tools: Installieren Sie das Playwright Chromium-Binary einmal nach npm install:

npx playwright install chromium

Installation

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

Konfiguration

Der Server liest Projektanmeldeinformationen aus der Umgebungsvariablen CLEVERTAP_PROJECTS — ein JSON-Array von Projektobjekten:

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

Unterstützte Regionen: in1, us1, eu1, sg1, aps3, mec1

Fallback für ein einzelnes Projekt

Sie können auch einzelne Umgebungsvariablen für ein einzelnes Projekt verwenden:

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

Zu Claude Desktop hinzufügen

In Ihrer claude_desktop_config.json (oder ~/.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\"}]"
      }
    }
  }
}

Wichtig: CLEVERTAP_PROJECTS muss ein serialisierter JSON-String (kein natives JSON-Objekt) innerhalb des env-Blocks sein.


Entwicklung

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

Projektstruktur

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)

Lizenz

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…

    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

    Related MCP Connectors

    Related MCP Servers