Amplitude MCP Server

The Amplitude Model Context Protocol (MCP) server enables teams to analyze product data, experiments, and user behavior using conversational AI. Query your Amplitude analytics, dashboards, experiments, and feature flags 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

Beta notice

The Amplitude MCP server is under active development. Some functions and settings may not be available, and you may experience bugs or performance issues during this period. This feature continues to evolve and might be subject to rate limits.

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, VS Code, Cursor, Replit, Claude Code).

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 dashboards, charts, notebooks, experiments, and other content in Amplitude with comprehensive filtering and personalization options
`query_chart`	Query chart data result using the internal dash API to get chart data
`query_metric`	Query metric data using the dataset endpoint with metric references
`query_experiment`	Query experiment analysis data using the dataset endpoint with proper experiment parameters
`query_dataset`	Execute a data query using the dataset endpoint for complex ad-hoc analysis within a project
`get_context`	Get context information about the current user, organization, and accessible projects
`get_charts`	Retrieve full chart objects by their IDs using the chart service directly
`get_dashboard`	Get specific dashboards and all their charts including chart IDs for individual queries
`get_notebook`	Get specific notebooks and all their charts including chart IDs for individual queries
`get_flags`	Retrieve feature flags from a project with optional filtering by deployment, type, and deleted status
`get_experiments`	Retrieve specific experiments by their IDs with additional information like state and decisions
`get_deployments`	Retrieve all deployments (Experiment API keys) for the current project
`get_metrics`	List all metrics from a project with optional filtering and sorting by various criteria
`get_metric`	Get detailed information about a specific metric by ID
`get_events`	Retrieve events from a project with optional filtering and sorting
`get_event_properties`	Retrieve event properties from a project with filtering options
`get_user_properties`	Retrieve user properties from a project with filtering options
`get_session_replays`	Search for session replays in the last 30 days, filtered by user properties or events.

Implementation instructions

Complete the steps below, depending on the tool you're integrating with.

Navigate to claude.ai or open 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.

Best for: Developers who prefer command-line interfaces.

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.

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 Tools & Integration tab and authenticate with Amplitude.

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.

Best for: Users who want to use Amplitude MCP with ChatGPT's developer mode.

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 press Connect to start the OAuth connection.
Complete Amplitude OAuth authorization when prompted.

For best results with ChatGPT, Amplitude recommends creating a Project specificly 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.

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
```

Using with other supported MCP Clients

For MCP-compatible clients:

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?

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.

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 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]

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.