# Amplitude MCP

> Amplitude connects your AI agent directly to detailed product analytics data. Query user activity streams, calculate retention curves, map conversion funnels, and pull daily active users or revenue figures using plain language prompts.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** user-behavior, product-analytics, retention-metrics, conversion-funnels, event-tracking

## Description

Stop switching tabs and building dashboards every time you need a quick metric. This MCP lets you talk to your product data like it's a conversation. You can ask complex questions—like 'How did the sign-up funnel change after we updated the payment page?'—and get real-time answers, all within your AI client. It pulls specific behavioral metrics, showing user journeys and where people drop off. Whether you need to track day-over-day retention or list recent behavioral cohorts, you just ask for it. Because this MCP is hosted on Vinkius, you connect once from any compatible agent, giving you instant access to product analytics alongside your other enterprise tools.

## Tools

### export_events
Exports raw Amplitude event data for a specific time range, useful for deep manual analysis.

### get_user_activity
Retrieves the detailed activity stream for an individual user, helping diagnose specific journeys.

### event_segmentation
Queries and analyzes event counts or unique users based on a specified name and date range.

### search_users
Finds specific user records using identifiers like email, device ID, or user ID before checking their activity.

### get_retention
Calculates day-over-day retention curves by tracking users from an acquisition event through a return event.

### get_funnel
Maps and calculates the conversion rate between multiple sequential events for a defined period.

### list_cohorts
Lists existing behavioral user groups (cohorts) and their current size for targeted analysis.

### get_cohort
Requests a specific cohort download, which can take some time to process in the background.

### revenue_analysis
Generates daily revenue reports for a specified start and end date range.

### active_users
Provides metrics for Daily, Weekly, or Monthly Active Users (DAU/WAU/MAU) over a defined period.

## Prompt Examples

**Prompt:** 
```
What's our funnel conversion from 'Landing_Page_View' to 'Sign_Up_Success' for the last 3 days?
```

**Response:** 
```
I checked the conversion funnel. Over the last 3 days, 14,200 users triggered 'Landing_Page_View'. Of those, 2,840 completed 'Sign_Up_Success'. This represents an overall conversion rate of 20%, which is slightly above our weekly average.
```

**Prompt:** 
```
Show the recent user activity for customer email@example.com
```

**Response:** 
```
I've pulled the activity stream for email@example.com. In the last 2 hours, they logged in, triggered 'Payment_Initiated', but then hit an error on 'Payment_Gateway_Failed'. You might want to review the exact property payload.
```

**Prompt:** 
```
What is our Daily Active Users (DAU) count since start of the month?
```

**Response:** 
```
I fetched the DAU data. Since the 1st of the month, DAU has ranged from 45,000 to 52,000. Yesterday hit a peak at 52,104, reflecting our recent campaign launch. Would you like a breakdown of revenue from this period?
```

## Capabilities

### Map individual user journeys
Get a complete chronological log of events for specific users or accounts.

### Measure conversion funnels
Analyze multi-step processes to pinpoint exactly where user drop-off occurs.

### Calculate user retention rates
Generate metrics that show if specific features or actions keep users engaged over time.

### Track adoption trends and segments
Query event counts and unique user activity across defined groups or time periods.

### Pull core business metrics
Instantly retrieve daily, weekly, and monthly active users (DAU/WAU/MAU) alongside total revenue data.

## Use Cases

### Diagnosing a sudden drop in sign-ups
A Product Manager notices conversions dipped last week. They prompt the agent: 'What was our funnel conversion from 'Landing_Page_View' to 'Sign_Up_Success' for the last 7 days?' The system uses `get_funnel` and reports that users are failing at the payment initiation step, directing the PM to the exact bottleneck.

### Investigating a high-value user's journey
A Customer Success agent has an angry enterprise client. They ask: 'Show me all recent activity for this account.' The agent uses `get_user_activity` and pulls the full log, revealing that the client hit a specific error message two hours ago, allowing the CS team to fix it immediately.

### Measuring campaign success
A Growth Lead runs a new email campaign. They ask: 'What was our DAU count since the start of this month?' The agent uses `active_users` and provides a comparison against last month's numbers, proving the campaign moved the needle.

### Understanding long-term product health
A Data Analyst wants to know if the new onboarding flow is sticky. They prompt for retention data using `get_retention`, which returns day-over-day curves that confirm users who complete step three stay engaged much longer.

## Benefits

- Pinpoint failure points immediately. Instead of building a funnel chart in a separate tool, you ask the agent to run `get_funnel` and tells you exactly where users stop engaging.
- Understand feature stickiness by generating retention curves. You can use `get_retention` to see if your latest update is actually making users stay longer.
- Stop guessing about user actions. The `get_user_activity` tool lets you pull an entire event stream for a single customer, letting Customer Success debug sessions instantly.
- Get the big numbers fast. Need DAU or daily revenue? Use `active_users` and `revenue_analysis` to get current metrics without writing SQL or clicking through dashboards.
- Group users by behavior automatically. You can use `list_cohorts` to see who belongs in which group, letting you target your growth efforts with precision.

## How It Works

The bottom line is you treat your complex analytics platform like an extension of your AI agent's knowledge base.

1. Subscribe to this MCP and provide your Amplitude API key and secret.
2. Your AI agent authenticates the connection, granting it access to your historical product event data.
3. You ask a natural language question—like 'What was our revenue last week?'—and receive immediate, actionable metrics without leaving your chat.

## Frequently Asked Questions

**How do I find out what specific users did using Amplitude MCP?**
Use the `search_users` tool first to locate the user by ID or email, and then immediately run `get_user_activity` to pull their exact event stream.

**Can I calculate retention rates with Amplitude MCP?**
Yes. You use the `get_retention` tool, specifying both the acquisition event (start) and the return event to generate accurate day-over-day curves.

**What is the best way to analyze conversion paths with Amplitude MCP?**
Run the `get_funnel` tool. You need to provide a comma-separated list of events and the date range; this tells you the step-by-step conversion flow.

**Does Amplitude MCP track daily revenue?**
Yes, use the `revenue_analysis` tool. Just specify the start and end dates for the period you want to analyze.

**Can I see the total number of active users with Amplitude MCP?**
Use the `active_users` tool. You can request Daily, Weekly, or Monthly Active Users (DAU/WAU/MAU) by providing a date range.