# CleverTap MCP for AI Agents MCP

> CleverTap connects your customer engagement and analytics data directly into any AI agent. Use this MCP to run reports, check user segments, and audit event streams using natural conversation. You can finally monitor campaign ROI and analyze user behavior without opening multiple dashboards.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** customer-engagement, retention-analytics, behavioral-analytics, omnichannel-messaging, user-segmentation

## Description

Managing modern marketing requires constant vigilance over how users interact with your product. Instead of jumping between analytics tabs or running complex SQL queries, you talk to the data. This MCP gives your AI agent full control over your customer engagement strategies within CleverTap.

It lets you pull specific performance reports for campaigns, list and monitor defined user segments, and even retrieve detailed profile information for single users on demand. You can audit what events are being tracked or see real-time usage counts instantly. This capability transforms how teams approach data—you stop waiting for reports and start asking questions. Since Vinkius hosts this MCP, you connect once to your favorite AI client (Claude, Cursor, etc.) and get access to all these tools.

It's about bringing deep marketing insights directly into the chat window.

## Tools

### get_campaign_performance_report
Pulls detailed performance metrics for a specific marketing campaign ID.

### get_user_profile_details
Retrieves the full profile and attribute information for any single user identity.

### get_real_time_usage_stats
Checks current, live counts of active users and general event statistics.

### list_clevertap_apps
Lists all applications that are currently registered within the CleverTap account.

### list_clevertap_campaigns
Retrieves a list of campaigns, including those scheduled over a defined date range.

### list_event_schemas
Lists all custom event schemas and their associated data structures.

### list_clevertap_segments
Shows a list of every defined user segment available in the account.

### list_user_profile_properties
Lists all possible attributes and properties that can be attached to user profiles.

## Prompt Examples

**Prompt:** 
```
What were the conversion rates for 'Welcome Email Series' last month?
```

**Response:** 
```
**Campaign Performance Report: Welcome Email Series**

*   **Total Sent:** 150,000 messages
*   **Clicks:** 12,750 (8.5% CTR)
*   **Conversions:** 3,187 (2.5% conversion rate)

The results show a solid performance, with the highest click volume coming from users in the Northeast region.
```

**Prompt:** 
```
Show me all my defined user segments and who is missing.
```

**Response:** 
```
**Segment Audit: Clevertap**

*   `High Value Users`: 12,450 members (Active)
*   `Churn Risk Group`: 890 members (Needs attention)
*   `New Signups - Last 7 Days`: 3,120 members (Healthy growth)

I notice the 'Premium Trial' segment hasn't been updated in two weeks. Would you like to check if there are any pending user events for that group?
```

**Prompt:** 
```
What kind of data can I pull about a specific customer?
```

**Response:** 
```
**User Profile Details: ID 90210**

Here is the deep dive on that account:

*   **Attributes:** Email, Signup Date (2023-01-15)
*   **Behavioral Data:** Last Viewed Product (Widget X), Total Orders (5)
*   **Segments:** Member of 'High Value Users' and 'Desktop User'.

The profile suggests this user is high value but hasn't engaged with the new mobile feature yet.
```

## Capabilities

### Review Campaign Performance
Get detailed performance metrics for a specific campaign ID.

### Audit User Data and Profiles
Retrieve comprehensive profile details or list all custom attributes associated with any user identity.

### Monitor Live Usage Statistics
Pull current, real-time counts of active users and general event statistics.

### Manage User Segments
List all existing user segments defined in your account to understand audience distribution.

### Check Campaign Statuses
List details for any scheduled or currently running marketing campaigns within a specific date range.

### Validate Data Schema
List custom event schemas and user properties to confirm that data is being tracked correctly.

## Use Cases

### Determining Campaign Success Post-Launch
A marketing manager needs to know if the 'Summer Sale Push' was effective. They ask their agent for the performance report, which instantly shows clicks and conversions without needing to open the campaign dashboard or run manual reports.

### Auditing New Feature Rollouts
A product manager rolls out a new checkout flow. To audit data ingestion, they ask their agent to list event schemas, confirming that 'Payment Successful' and 'Shipping Address Viewed' events are properly captured.

### Targeting High-Value Users
A retention lead wants to understand the most valuable users. They request detailed profile information for specific user IDs, instantly seeing attributes like lifetime value or sign-up source.

### Checking Segment Health Before Launch
Before sending a major campaign, an ops specialist uses list_clevertap_segments to verify that the 'High Engagement Users' segment still contains enough people and hasn't shrunk unexpectedly.

## Benefits

- Campaign Oversight: Instead of digging into the dashboard, you simply ask your agent to get detailed metrics for any running or scheduled campaign.
- Audit Data Integrity: Use list_event_schemas to immediately check if all required custom events are being tracked correctly, saving hours of data validation.
- Deep User Insights: Get immediate access to profile details using get_user_profile_details; you can pull specific user data without complex lookups.
- Real-Time Visibility: Check current active user counts and event stats instantly with get_real_time_usage_stats, giving an always-current pulse on your product.
- Segment Management: List all defined user segments using list_clevertap_segments to quickly understand audience distribution and identify gaps in targeting.

## How It Works

The bottom line is that you get deep marketing analytics without ever leaving your chat interface.

1. Subscribe to this MCP and provide your CleverTap Account ID, API Passcode, and Region.
2. Connect the credential set to any compatible AI client (Claude, Cursor, etc.) in Vinkius.
3. Ask your agent specific questions, like 'Show me the performance report for last month's welcome series.' The agent then uses the tools to pull and format the data directly.

## Frequently Asked Questions

**How can I use CleverTap MCP to check if my campaigns are working?**
You can get immediate performance reports by asking your agent for a specific campaign's metrics. It pulls the total messages sent, click-through rates, and conversion totals—all in one answer.

**Does CleverTap MCP help me manage user segments?**
Yes, it lets you list all your defined segments quickly. You can verify if a segment is still active or identify which groups need re-evaluation before launching a promotion.

**Can I find out what data points are available for users?**
You can use the MCP to audit user profiles and list all possible attributes. This lets you know exactly what behavioral or demographic data CleverTap has collected on any single user ID.

**What if I need to verify my tracking events?**
The MCP allows you to list your custom event schemas. This quickly confirms that the specific events, like 'Search Executed', are configured correctly in CleverTap and ready for data collection.

**How do I monitor current user activity using CleverTap MCP?**
You can pull real-time usage statistics. This gives you an instant count of active users and the volume of events happening right now, perfect for checking product health during a live deployment.

**Is CleverTap MCP better than just using the web dashboard?**
It's faster because it eliminates context switching. Instead of logging into the platform and clicking through multiple reports, you ask your agent questions and get immediate, synthesized answers in your chat.