ralphcorleone/clevertap-mcp

API 开发

本页由 AI 翻译，技术细节请以原文为准。查看原文

6 stars 5 forks 质量 61 趋势 14

Repository Install

MCP Clevertap API

概览

A Model Context Protocol (MCP) server for the CleverTap REST API. Exposes CleverTap's user profiles, events, campaigns, and reports as tools that any MCP-compatible AI assistant (Claude, Cursor, etc.) can call directly. - — manage multiple CleverTap accounts from a single server instance - — if no project is configured, clevertap_configure walks you through the process - — events, profiles, campaigns, and reports - — long-running operations (event/profile counts) are polled automatically install the Playwright Chromium binary once after npm install: The server reads project credentials from the CLEVERTAP_PROJECTS environment variable — a JSON array of project objects: You can also use individual environment variables for a single project: In your claude_desktop_config.json (or ~/.claude.json): CLEVERTAP_PROJECTS must be a serialized JSON (not a native JSON object) inside the env block.

README

以下为原文 README 节选，完整内容请查看原文。

clevertap-mcp

A Model Context Protocol (MCP) server for the CleverTap REST API. Exposes CleverTap’s user profiles, events, campaigns, and reports as tools that any MCP-compatible AI assistant (Claude, Cursor, etc.) can call directly.

Features

Multi-project — manage multiple CleverTap accounts from a single server instance
Guided setup — if no project is configured, clevertap_configure walks you through the process
Full API coverage — events, profiles, campaigns, and reports
Async polling — long-running operations (event/profile counts) are polled automatically

Tools

Events

Tool	Description
`clevertap_upload_events`	Upload one or more events for a user
`clevertap_get_events`	Query event data with filters
`clevertap_get_events_cursor`	Fetch the next page of event results via cursor
`clevertap_get_event_count`	Get the total count of an event (with async polling)

Profiles

Tool	Description
`clevertap_upload_profiles`	Create or update user profiles
`clevertap_get_profile`	Look up a single user by identity, email, or objectId
`clevertap_get_profiles_by_event`	Get profiles of users who performed an event
`clevertap_get_profiles_cursor`	Fetch the next page of profile results via cursor
`clevertap_delete_profile`	Delete a user profile
`clevertap_upload_device_token`	Register a push token for a user
`clevertap_get_profile_count`	Count profiles matching a segment
`clevertap_demerge_profiles`	Split merged profiles apart
`clevertap_subscribe`	Subscribe/unsubscribe a user to channels
`clevertap_disassociate_phone`	Remove a phone number from a profile

Campaigns

Tool	Description
`clevertap_get_campaigns`	List campaigns within a date range
`clevertap_get_campaign_report`	Get delivery and engagement stats for a campaign
`clevertap_stop_campaign`	Stop a running campaign
`clevertap_create_campaign`	Create and launch a campaign

Reports

Tool	Description
`clevertap_get_message_report`	Message-level delivery report
`clevertap_get_top_property_count`	Top property value counts for an event
`clevertap_get_event_trend`	Daily/weekly/monthly trend for an event
`clevertap_get_dau`	Daily active users trend
`clevertap_get_uninstall_report`	Uninstall trend report
`clevertap_get_real_time_counts`	Real-time active user counts

Generic

Tool	Description
`clevertap_request`	Make any raw REST API request

在 GitHub 查看完整 README

安装

npx playwright install chromium # required for web/browser tools

新手？先看 mcpskill.org 教程 →

配置

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

Tool	Description
`clevertap_configure`	Guided setup to add a project or generate the `CLEVERTAP_PROJECTS` config
`clevertap_list_projects`	List all configured projects and their regions