Amplitude MCP Server

The Amplitude Model Context Protocol (MCP) server enables teams to analyze product data, experiments, and user behavior using conversational AI. Query and create Amplitude content including charts, dashboards, experiments, and cohorts directly through AI interfaces using natural language.

The Amplitude MCP server is listed in the official MCP servers registry on GitHub. You can also find MCP integration guides and examples in Anthropic's Claude documentation, the MCP quickstart resources, and Cursor's MCP documentation.

Remote server

Who can use this feature

Available to any existing Amplitude customer.
You must use a code editor or application that supports MCP servers (for example, Cursor, Claude Code, ChatGPT, Lovable, or AWS Kiro).

Regions

Region	MCP Server URL
United States Server (Default)	`https://mcp.amplitude.com/mcp`
EU Residency Server	`https://mcp.eu.amplitude.com/mcp`

Use the Standard Server URL unless your Amplitude data resides in the EU region.

Available tools and capabilities

The Amplitude MCP provides comprehensive access to your analytics through these tools:

Available tools

Tool Name	Description
`search`	Search for charts, dashboards, notebooks, experiments, events, properties, cohorts, and other Amplitude content.
`get_from_url`	Retrieve the full object definition from any Amplitude URL, including charts, dashboards, and experiments.
`get_context`	Get information about the current user, organization, and accessible projects.
`get_charts`	Retrieve full chart definitions by ID, including events, properties, and configuration.
`get_dashboard`	Retrieve dashboards and all their charts, including chart IDs for individual queries.
`get_cohorts`	Retrieve cohort definitions by ID, including audience criteria and metadata.
`get_experiments`	Retrieve experiments by ID with state, variant configuration, and decision details.
`get_event_properties`	Retrieve properties for specific events with filtering options.
`get_session_replays`	Search for session replays from the last 30 days, filtered by user properties or events.
`get_users`	Retrieve user data from a project.
`query_chart`	Query a single chart by ID and return its data.
`query_charts`	Query up to three charts concurrently by ID and return their data.
`query_dataset`	Execute ad-hoc data queries for event segmentation, funnels, retention, and session analysis.
`query_experiment`	Query experiment analysis data, including variant performance and statistical significance.
`save_chart_edits`	Save edits to existing charts or convert temporary chart edits into permanent saved charts.
`create_chart`	Create a new chart from a query definition.
`create_dashboard`	Create dashboards with charts, rich text, and custom layouts.
`create_notebook`	Create interactive notebooks with charts, rich text, and multi-column layouts.
`create_experiment`	Create A/B test experiments across one or more projects with custom variants and metrics.
`create_cohort`	Create cohorts based on user properties and behaviors.
`get_feedback_insights`	Retrieve processed feedback themes grouped by type: feature requests, bugs, complaints, praise, and pain points.
`get_feedback_comments`	Retrieve raw feedback comments from connected sources with search and pagination.
`get_feedback_mentions`	Retrieve individual user feedback comments associated with a specific insight.
`get_feedback_sources`	Retrieve connected feedback integrations and their source IDs for filtering.

Implementation instructions

Select your MCP client for setup instructions.

Claude Code

For general MCP setup, refer to the Claude Code MCP documentation.

Add the MCP server globally:
```
claude mcp add -t http -s user Amplitude "https://mcp.amplitude.com/mcp"
```
Note
EU customers should use https://mcp.eu.amplitude.com/mcp instead.
Start Claude Code:
```
claude
```
Authenticate with Amplitude:
```
/mcp
```
Follow the authentication flow.

Cursor

For general MCP setup, refer to Cursor's MCP documentation.

Quick install (recommended):

US server (default): Install Amplitude MCP Server deep link (US)

EU server: Install Amplitude MCP Server deep link (EU)

Manual setup:

Open Cursor Settings: Cursor > Settings… > Cursor Settings.
Navigate to Tools & Integrations > New MCP Server.

Add this configuration to your mcp.json:

{
  "mcpServers": {
    "Amplitude": {
      "url": "https://mcp.amplitude.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Note

EU customers should use https://mcp.eu.amplitude.com/mcp instead.

Return to the Tools & Integrations tab and authenticate with Amplitude.

ChatGPT

For general MCP setup, refer to the OpenAI remote MCP documentation.

Note

MCP support in ChatGPT is available through developer mode, which provides full Model Context Protocol client support for both read and write operations. OpenAI is working to expand MCP support beyond this beta preview mode, including availability for enterprise organizations.

Navigate to ChatGPT or open the ChatGPT desktop app.
Go to Settings > Apps & Connectors > Browse Connectors.
Select Amplitude, then select Connect to start the OAuth connection.
Complete Amplitude OAuth authorization when prompted.

For best results, Amplitude recommends creating a ChatGPT project specifically for the Amplitude MCP and adding this prompt to the instructions:

When using Amplitude MCP, follow these rules then act quickly and autonomously:
- Use tools to find answers: If you need info (events, properties, chart definitions, cohorts), use tools to discover it rather than asking the user. Trust the Amplitude MCP tools provide access to actual data behind charts, dashboards, and other entities. Always attempt using tools before saying they don't exist.
- Try NOT to ask clarifying questions: Make your best judgment with information available but sparingly elicit clarification from users
- Resolve ambiguity yourself: When multiple options exist (e.g., which project to use, which saved chart or event matches best, how to define a segment), choose the most reasonable option based on tool results and context. Search saved charts, metrics, and other data before creating something new.
- When responding to requests that involve Amplitude objects (charts, dashboards, or any entity), don't stop at referencing IDs and metadata. Retrieve underlying data, run analysis based on it, then share specific metrics as part of your analysis.
- Complete the request: Execute the workflow requested, proactively share relevant data when analyzing, don't stop partway to ask for confirmation, then provide data-backed, actionable, and concise answers.
- Report what you did: After completing the task, briefly explain key assumptions or data used
- Cite your sources: When referencing data from Amplitude, include the link as part of the markdown response (()[])

Start asking questions about your Amplitude data.

Claude

For general MCP connector setup, refer to the Claude remote MCP server documentation.

Navigate to claude.ai or open the Claude desktop app.
Go to Settings > Connectors > Add custom connector.
Configure the integration:
- Name: Amplitude
- URL: https://mcp.amplitude.com/mcp
Note
EU customers should use https://mcp.eu.amplitude.com/mcp instead.
Complete Amplitude OAuth authorization when prompted.
Start asking questions about your Amplitude data.

Gemini CLI

For general MCP setup, refer to the Gemini CLI MCP documentation.

Ensure you're authenticated with Gemini.

Add this to your ~/.gemini/settings.json:

{
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "amplitude": {
      "httpUrl": "https://mcp.amplitude.com/mcp"
    }
  }
}

Note

EU customers should use https://mcp.eu.amplitude.com/mcp instead.

Restart the MCP server and authenticate:
```
gemini/mcp auth amplitude
```

Replit

For general MCP setup, refer to the Replit MCP documentation.

Quick install (recommended):

US server (default): Add Amplitude MCP Server to Replit

EU server: Add Amplitude MCP Server to Replit (EU)

Manual setup:

Navigate to your Replit workspace settings.
Go to Integrations > MCP Servers.
Add a new MCP server with this configuration:
- Name: Amplitude
- URL: https://mcp.amplitude.com/mcp
Note
EU customers should use https://mcp.eu.amplitude.com/mcp instead.
Complete Amplitude OAuth authorization when prompted.
Start asking questions about your Amplitude data.

Lovable

For general MCP setup, refer to the Lovable MCP documentation.

Log in to Lovable.
Select your avatar, then go to Settings.
Select Connectors.
Search for Amplitude in the search box.
Complete Amplitude OAuth authorization when prompted.
Start asking questions about your Amplitude data in the Lovable chat.

Figma Make

For general MCP connector setup, refer to the Figma Make connector documentation.

Open a Figma Make file.
Select the + icon, then Connectors.
In the Partners tab, find Amplitude and select Connect.
Complete Amplitude OAuth authorization when prompted.
In the chat input, select the + icon, then Connectors, then Amplitude to start using the MCP server.

Note

Figma Make has a data limit that may cause initial tool calls to fail. They should recover with lower limits.

AWS Kiro

For general MCP setup, refer to the Kiro MCP documentation.

Open the Kiro IDE.
Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux) and search for "MCP", or go to File > Settings and open the mcp.json configuration file.
Select the scope for your configuration:
- User settings: Applies to all projects.
- Workspace Config: Applies to the current project only.

Add this configuration to your mcp.json:

{
  "mcpServers": {
    "amplitude-mcp": {
      "type": "http",
      "url": "https://mcp.amplitude.com/mcp"
    }
  }
}

Note

EU customers should use https://mcp.eu.amplitude.com/mcp instead.

Save the configuration file.
In the MCP Servers section, verify the status shows Connected. If prompted, sign in to Amplitude through your default browser.

Codex CLI

For general MCP setup, refer to the OpenAI Codex CLI MCP documentation.

Add the Amplitude MCP server:
```
codex mcp add amplitude --url https://mcp.amplitude.com/mcp
```
Note
EU customers should use https://mcp.eu.amplitude.com/mcp instead.
Follow the authentication flow when prompted.

Other MCP clients

For MCP-compatible clients not listed above:

Configure your client to connect to https://mcp.amplitude.com/mcp.

Note
EU customers should use https://mcp.eu.amplitude.com/mcp instead.
Ensure your client supports OAuth authentication.
Set up the connection according to your client's documentation.
Authenticate with your Amplitude account when prompted.
Select which Amplitude tools to enable based on your needs.

Query examples

Basic analytics queries

What were the daily active users over the last 7 days?

Show signup conversion rates by traffic source this month.

Which features have the highest engagement rates?

Creation workflows

Create a dashboard showing our key product metrics.

Create an experiment to test the new checkout flow with a 50/50 split.

Create a cohort of users who completed onboarding in the last 30 days.

Edit the retention chart to show weekly instead of monthly data.

Build a cohort of power users who have used the product more than 10 times.

Experiment analysis

What's the performance of the checkout experiment?

Show the statistical significance of the new onboarding flow.

Which experiment variants are running?

Content discovery

Find all charts related to user retention.

Search for dashboards containing mobile app metrics.

Show experiments testing the payment flow.

User and cohort analysis

Show me users who signed up in the last week.

What cohorts exist for high-value customers?

Analyze the behavior of users in the "Active Users" cohort.

Customer feedback analysis

What are the main insights from customer feedback this month?

Show me recent customer feedback comments about the mobile app.

Which feedback sources are generating the most mentions?

Advanced analysis

Compare user behavior between iOS and Android platforms.

What's the typical user journey for power users?

Analyze feature adoption rates after the recent product launch.

Typical workflows

Analysis workflow

Most analysis questions follow this pattern:

Search: Find relevant content (charts, dashboards, experiments)
Retrieve: Get full definitions and metadata
Query: Execute data queries and analysis
Analyze: Ask follow-up questions and dive deeper

Example conversation flow:

User: Show me user retention data. AI: [Searches for retention-related charts]
AI: [Retrieves chart definitions]
AI: [Queries the data and presents results] User: Can you break this down by user segment? AI: [Modifies query to include segmentation]

Creation workflow

You can create new content directly through natural language:

Create: Build new charts, dashboards, experiments, or cohorts.
Configure: Specify parameters and settings through conversation.
Refine: Edit and adjust based on your needs.
Deploy: Save and use the created content in Amplitude.

Example conversation flow:

User: Create a dashboard for mobile app metrics. AI: [Creates dashboard with relevant charts] User: Add a chart showing daily active users by platform. AI: [Adds chart to the dashboard] User: Create a cohort of users who completed checkout. AI: [Creates cohort with specified criteria]

Plugins

The Amplitude MCP Marketplace is the official plugin repository for Amplitude MCP. It provides a curated set of reusable skills that extend what you can do with the Amplitude MCP server in Claude Code, Cursor, and Claude.

Install the plugin

# Add the Amplitude marketplace (one-time)
/plugin marketplace add amplitude/mcp-marketplace

# Install the analysis plugin
/plugin install amplitude@amplitude

Available skills

The amplitude plugin includes the following skills:

Skill	Description
analyze-chart	Deep-dive into a specific chart to explain trends, anomalies, and likely drivers.
analyze-dashboard	Synthesize an entire dashboard into talking points, surface concerns, and connect quantitative data to qualitative insights.
analyze-experiment	Analyze running or completed A/B tests and interpret results with statistical rigor, including ship and no-ship recommendations.
analyze-feedback	Synthesize customer feedback into grouped themes such as feature requests, bugs, pain points, and praise.
analyze-account-health	Summarize B2B account health including usage patterns, engagement trends, risk signals, and expansion opportunities.
create-chart	Create Amplitude charts from natural language, with automatic event discovery, filters, groupings, and visualization.
create-dashboard	Build dashboards from requirements or goals, organizing charts into logical sections with appropriate layouts.

Skills activate automatically based on your request. For example, asking "Why did this metric spike last week?" triggers the analyze-chart skill, and asking "Summarize this dashboard for my exec meeting" triggers analyze-dashboard.

Security and compliance

Data access

The MCP server uses your existing Amplitude user permissions and access controls.
You can only access Amplitude projects and data that you already have permission to view in your regular Amplitude account.
You receive no additional data access beyond your current Amplitude account privileges
OAuth authentication ensures secure connection between the MCP server and your Amplitude account.

Privacy considerations

The AI service you're using (for example, Claude or Gemini) processes your Amplitude data. Review your organization's policies regarding AI-powered data analysis tools and consider compliance requirements (General Data Protection Regulation, California Consumer Privacy Act).

Third parties (for example, Anthropic) develop and maintain the AI models used with this MCP server. Amplitude isn't responsible for model outputs, including hallucinations, inaccuracies, or errors resulting from model behavior, even if such outputs use your Amplitude data.

Admin controls

MCP server access is enabled by default for all users in your organization. Organization administrators can opt out or restrict access if needed:

Navigate to Settings > Content Access > MCP in your Amplitude organization settings.
Use the content access controls to allow or block the Amplitude MCP server.
Access restrictions apply to all MCP clients across all users in your organization.

Note

MCP access controls are an admin-only setting. Individual users can't override organization-level MCP restrictions.

Troubleshooting

Common issues

Authentication and OAuth Issues

Ensure your Amplitude account has proper project access.
Check that you have logged into the correct Amplitude account.
Make sure you're only logged into one Amplitude organization during the OAuth flow. Logging into multiple organizations can cause authentication issues.
Try disconnecting the MCP connection and re-authenticating through the OAuth flow.
Try logging out of Amplitude, then reconnecting.
Desktop apps may require restart after configuration changes.
Authorization page may appear to spin indefinitely (close tab after authentication).

Missing Data

Verify you have access to the specific Amplitude project.
Check if the data exists in your Amplitude interface.
Ensure proper permissions for the requested data.

Chart Query Issues

AI platforms may truncate some large charts.
Querying charts from dashboards may use default chart settings instead of saved dashboard filters.

MCP Client Issues

Cursor tool call failures: If MCP tool calls fail in Cursor, this is often due to expired or corrupted authentication tokens. Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows/Linux), type and select "Clear All MCP Tokens," then re-authenticate with your accounts.
Token limit errors: If you receive token limit exceeded errors, try starting a new conversation thread or increase the maximum token limit in your MCP client settings.
Connection timeouts: If queries are timing out, try breaking down complex requests into smaller, more focused questions.
Tool loading failures: If tools aren't loading, restart your MCP client application and re-authenticate.

Getting help

If you encounter issues not covered here:

Verify your setup matches the configuration examples.
Test with a simple query like "What Amplitude projects are accessible?"
Check that your Amplitude account has the necessary permissions.
Contact your Amplitude administrator for organization-specific setup help.

Send feedback

Amplitude is constantly improving the Amplitude MCP server and would appreciate hearing from you. Share your feedback, suggestions, or report issues using this feedback form.

Technical specifications

Transport Type: Streaming HTTP (Remote).

Authentication: OAuth 2.0 with Amplitude.