clevertap-mcp
clevertap-mcp
CleverTap REST API用のModel Context Protocol (MCP)サーバーです。CleverTapのユーザープロファイル、イベント、キャンペーン、レポートを、MCP互換のAIアシスタント(Claude、Cursorなど)が直接呼び出せるツールとして公開します。
機能
マルチプロジェクト — 単一のサーバーインスタンスから複数のCleverTapアカウントを管理
ガイド付きセットアップ — プロジェクトが設定されていない場合、
clevertap_configureがプロセスを案内完全なAPIカバレッジ — イベント、プロファイル、キャンペーン、レポート
非同期ポーリング — 長時間実行される操作(イベント/プロファイルのカウント)は自動的にポーリング
Related MCP server: Mixpanel MCP Server
ツール
メタ
ツール | 説明 |
| プロジェクトの追加や |
| 設定済みの全プロジェクトとそのリージョンを一覧表示 |
イベント
ツール | 説明 |
| ユーザーのイベントを1つ以上アップロード |
| フィルターを使用してイベントデータをクエリ |
| カーソルを使用してイベント結果の次のページを取得 |
| イベントの合計数を取得(非同期ポーリングを使用) |
プロファイル
ツール | 説明 |
| ユーザープロファイルの作成または更新 |
| ID、メールアドレス、またはobjectIdで単一のユーザーを検索 |
| 特定のイベントを実行したユーザーのプロファイルを取得 |
| カーソルを使用してプロファイル結果の次のページを取得 |
| ユーザープロファイルを削除 |
| ユーザーのプッシュトークンを登録 |
| セグメントに一致するプロファイルをカウント |
| マージされたプロファイルを分割 |
| ユーザーのチャネル購読/購読解除 |
| プロファイルから電話番号を削除 |
キャンペーン
ツール | 説明 |
| 指定期間内のキャンペーンを一覧表示 |
| キャンペーンの配信およびエンゲージメント統計を取得 |
| 実行中のキャンペーンを停止 |
| キャンペーンを作成して開始 |
レポート
ツール | 説明 |
| メッセージレベルの配信レポート |
| イベントのプロパティ値のカウント上位を取得 |
| イベントの日次/週次/月次トレンド |
| デイリーアクティブユーザー(DAU)のトレンド |
| アンインストールトレンドレポート |
| リアルタイムのアクティブユーザー数 |
汎用
ツール | 説明 |
| 任意の生のREST APIリクエストを実行 |
|
|
Web / ブラウザ
ツール | 説明 |
| Chromiumウィンドウを開き、手動ログイン後にダッシュボードのセッションCookieとCSRFトークンをキャプチャ(SSOおよび2FAをサポート) |
| プロジェクトのWebセッションがキャプチャされているか、いつ取得されたかを確認 |
| キャプチャしたセッションを使用して、CleverTapダッシュボードの任意のエンドポイントへ認証済みリクエストを実行 |
| ダッシュボードUI APIからキャンペーンを一覧表示 — REST APIよりも豊富なデータ(ステータス、送信数、インプレッション、クリック、編集URL) |
| 特定のデバイストークンにテストプッシュ通知を送信。 |
Webツールの前提条件:
npm installの後に、Playwright Chromiumバイナリを一度インストールしてください: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=us1Claude 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は、envブロック内で(ネイティブのJSONオブジェクトではなく)シリアライズされたJSON文字列である必要があります。
開発
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 toolclevertap_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
Scored across 1 tool
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.
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.
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.
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
Related MCP Connectors
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
MCP server for AI access to Swagger by SmartBear.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables AI tools to interact with ActiveCampaign API, allowing contact management and tracking event analysis through natural language queries.51MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides access to the Mixpanel REST API, enabling AI agents to query events, funnels, retention data, and user profiles. It allows users to perform complex analytics tasks and export raw event data through natural language prompts.16MIT
- AlicenseNot gradedqualityBmaintenanceMCP server enabling AI assistants to interact with ClickUp workspaces, including task management, comments, time tracking, and document operations.85 npmMIT
- FlicenseNot gradedqualityCmaintenanceRead-only AI analytics assistant for CleverTap via MCP, enabling querying of events, profiles, campaigns, and realtime data without write endpoints.23 npm-