- Amplitude
Amplitude
<style>
/* Prism’s critical code-block styles only */
code[class*="language-"],
pre[class*="language-"] {
color: #2a2a2a;
background: #f5f2f0;
font-family:"IBM Plex Mono", Consolas, Menlo, monospace;
font-size: 0.9em;
white-space: pre;
/* …etc, just the essentials… */
}
</div>
</div>
</div>
<div class="top-12 left-0 right-0 fixed bg-white z-10">
<div class="w-full overflow-scroll md:overflow-auto pt-5 pl-5">
<div class="box-border">
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/get-started">Get Started</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/data">Data</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative top-nav-active"><a class="no-underline font-normal text-amp-blue-500 font-medium " href="/docs/analytics">Analytics</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/session-replay">Session Replay</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/guides-and-surveys">Guides and Surveys</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/experiment-home">Experiment</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/admin">Admin</a></div>
<div class="flex-initial mr-4 text-sm p-2 inline w-max" x-data="{ open: false }"><button
@click="open = !open" class="font-normal -mb-[11px] text-[#111827]">Developers <svg class="inline fill-[#111827]" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-cloak x-show="open" x-transition @click.outside="open = false" class="mt-4 py-2 right-4 sm:right-auto absolute border border-amp-gray-100 rounded flex flex-col shadow-lg top-4 bg-white w-48 p-4 font-normal z-20">
<a class="no-underline pl-4 py-2 font-light hover:bg-amp-blue-950 hover:rounded" href="/docs/sdks">SDKs</a>
<a class="no-underline pl-4 py-2 font-light hover:bg-amp-blue-950 hover:rounded" href="/docs/apis">APIs</a>
</div>
</div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/partners">Partners</a></div>
<div class="flex-initial mr-4 text-sm p-2 transition hover:bg-amp-blue-950 hover:rounded hover:p-2 relative"><a class="no-underline font-normal " href="/docs/faq">FAQ</a></div>
</div>
</div>
</div>
<div
class="w-64 top-24 bg-white bottom-0 border-solid border-r border-black-200 -left-60 lg:left-0 lg:translate-x-0 lg:block z-10 fixed transition shadow overflow-visible lg:overflow-auto lg:overscroll-contain" :class="{ 'translate-x-[240px]': sidebarOpen }">
<button @click="sidebarOpen = !sidebarOpen" class="absolute lg:hidden left-0 z-50 w-4 translate-x-[245px] translate-y-8" :class="{ 'rotate-180': sidebarOpen, 'translate-x-[250px]' : sidebarOpen }"><svg xmlns="http://www.w3.org/2000/svg" width="21" height="24" viewBox="0 0 21 24" fill="none"><rect x="0.5" y="0.5" width="20" height="23" rx="3.5" fill="white"/><rect x="0.5" y="0.5" width="20" height="23" rx="3.5" stroke="#DEDFE2"/><g clip-path="url(#clip0_671_1270)"><path d="M11.007 11.8L8.09998 8.893L8.99298 8L12.793 11.8L8.99298 15.6L8.09998 14.707L11.007 11.8Z" fill="#1E2024"/></g><defs><clipPath id="clip0_671_1270"><rect width="16" height="16" fill="white" transform="translate(2.5 4)"/></clipPath></defs></svg></button>
<div class="h-full overflow-scroll overscroll-contain">
<div>
<a href="/docs/analytics/compare-cohorts"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Compare and manage your behavioral cohorts</a>
<div>
<a href="/docs/analytics/create-cohorts"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Create cohorts with Microscope, file import, or the Segmentation module</a>
<div>
<a href="/docs/analytics/track-cohort-changes"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Track changes in your cohort populations over time</a>
</div>
<button
@click.prevent="lvl2 = (lvl2 === 'historical-count' ? null : 'historical-count')"
class="text-left text-[.875rem] py-2 pl-2 relative"
:class="lvl2 === 'historical-count' ? 'active' : ''">Historical Count
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl2 === 'historical-count'" class="nav-level-3 flex flex-col my-0 pl-2">
<div>
<a href="/docs/analytics/historical-count-1"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Historical Count, part 1: Track user behavior for different instances of each user action</a>
<div>
<a href="/docs/analytics/historical-count-2"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Historical Count, part 2: Order of operations</a>
<div>
<a href="/docs/analytics/historical-count-3"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Historical Count, part 3: Funnels and behavioral cohorts</a>
</div>
</div>
<button @click.prevent="lvl1 = (lvl1 === 'organize-your-analyses') ? '' : 'organize-your-analyses'"
class="nav-button text-left text-[.875rem] my-0 py-[.25rem] pl-2 relative"
:class="lvl1 === 'organize-your-analyses' ? 'active' : ''">Organize your Analyses
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl1 === 'organize-your-analyses'" class="nav-level-2 flex flex-col my-0 pl-4"
>
<a href="/docs/analytics/customize-home-page"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Customize the Home page</a>
<a href="/docs/analytics/search"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Search: Find charts, dashboards, cohorts, and notebooks</a>
<a href="/docs/analytics/workspace"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Workspace: Find your charts and track your work</a>
<a href="/docs/analytics/bulk-manage-charts-with-chart-cleanup"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Bulk manage charts with Chart Cleanup</a>
<a href="/docs/analytics/releases"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Releases: See how users respond to changes in your product</a>
<button
@click.prevent="lvl2 = (lvl2 === 'dashboards' ? null : 'dashboards')"
class="text-left text-[.875rem] py-2 pl-2 relative"
:class="lvl2 === 'dashboards' ? 'active' : ''">Dashboards
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl2 === 'dashboards'" class="nav-level-3 flex flex-col my-0 pl-2">
<div>
<a href="/docs/analytics/dashboard-create"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Create, edit, and manage dashboards</a>
<div>
<a href="/docs/analytics/dashboard-filter"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Filter your dashboards</a>
<div>
<a href="/docs/analytics/dashboard-preferences"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Change your dashboard's display preferences</a>
<div>
<a href="/docs/analytics/dashboard-create-template"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Turn your dashboard into a template</a>
<div>
<a href="/docs/analytics/dashboard-subscribe"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
>Subscribe to a dashboard</a>
</div>
</div>
<button @click.prevent="lvl1 = (lvl1 === 'share-with-team-members') ? '' : 'share-with-team-members'"
class="nav-button text-left text-[.875rem] my-0 py-[.25rem] pl-2 relative"
:class="lvl1 === 'share-with-team-members' ? 'active' : ''">Share with team members
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl1 === 'share-with-team-members'" class="nav-level-2 flex flex-col my-0 pl-4"
>
<a href="/docs/analytics/collaborate-with-spaces"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Collaborate on your analyses using spaces</a>
<a href="/docs/analytics/notebooks"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Notebooks: Explain important insights to teammates and stakeholders</a>
<a href="/docs/analytics/templates"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Templates: Re-use your analyses</a>
<a href="/docs/analytics/ootb-marketing-analytics"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Out-of-the-box Marketing Analytics</a>
<a href="/docs/analytics/product-analytics"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Out-of-the-box Product Analytics</a>
<a href="/docs/analytics/out-of-the-box-metrics"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Out-of-the-box Metrics</a>
</div>
<button @click.prevent="lvl1 = (lvl1 === 'share-your-work') ? '' : 'share-your-work'"
class="nav-button text-left text-[.875rem] my-0 py-[.25rem] pl-2 relative"
:class="lvl1 === 'share-your-work' ? 'active' : ''">Share your Work
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl1 === 'share-your-work'" class="nav-level-2 flex flex-col my-0 pl-4"
>
<a href="/docs/analytics/share-dashboards"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Share dashboards within your company</a>
<a href="/docs/analytics/share-external"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Share charts, dashboards, and notebooks with stakeholders outside your company</a>
<a href="/docs/analytics/atlassian-smart-links"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Use Atlassian Smart Links with Amplitude</a>
<a href="/docs/analytics/chart-embed-notion"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Embed Amplitude charts in Notion documents</a>
<a href="/docs/analytics/integrate-miro"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Integrate Miro with Amplitude</a>
<a href="/docs/analytics/integrate-slack"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Integrate Slack with Amplitude</a>
<a href="/docs/analytics/google-drive-sync"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Sync your Amplitude data to Google Drive and Sheets</a>
</div>
<button @click.prevent="lvl1 = (lvl1 === 'account-level-reporting') ? '' : 'account-level-reporting'"
class="nav-button text-left text-[.875rem] my-0 py-[.25rem] pl-2 relative"
:class="lvl1 === 'account-level-reporting' ? 'active' : ''">Account-level Reporting
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl1 === 'account-level-reporting'" class="nav-level-2 flex flex-col my-0 pl-4"
>
<a href="/docs/analytics/account-level-reporting"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Account-level reporting in Amplitude</a>
<a href="/docs/analytics/plan-your-accounts-instrumentation"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Plan your Accounts Instrumentation</a>
<a href="/docs/analytics/account-level-reporting-setup"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Set up account-level reporting</a>
</div>
<button @click.prevent="lvl1 = (lvl1 === 'find-and-fix-anomalies') ? '' : 'find-and-fix-anomalies'"
class="nav-button text-left text-[.875rem] my-0 py-[.25rem] pl-2 relative"
:class="lvl1 === 'find-and-fix-anomalies' ? 'active' : ''">Find and Fix Anomalies
<svg class="inline absolute right-0" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 20 20" fill="none"><g id="icon-chevron-down"><path id="Vector" d="M10.25 10.6338L13.8837 7L15 8.11625L10.25 12.8663L5.5 8.11625L6.61625 7L10.25 10.6338Z" fill="#5A5E68"/></g></svg></button>
<div x-show="lvl1 === 'find-and-fix-anomalies'" class="nav-level-2 flex flex-col my-0 pl-4"
>
<a href="/docs/analytics/anomaly-forecast"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Anomaly + Forecast: Find anomalies in your data</a>
<a href="/docs/analytics/insights"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Insights: Spot anomalies in your metrics quickly with alerts</a>
<a href="/docs/analytics/root-cause-analysis"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Root Cause Analysis: Track down anomalies in your data</a>
<a href="/docs/analytics/debug-analytics"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Debug Analytics</a>
<a href="/docs/analytics/domain-proxy"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Use Domain Proxy to Relay Events</a>
<a href="/docs/analytics/user-data-lookup"
class="no-underline block text-[.875rem] p-2 leading-5 hover:bg-amp-gray-50 hover:rounded text-amp-gray-600"
">Look up event data for individual users</a>
</div>
<div class="flex flex-row hover:bg-amp-gray-50 hover:rounded ">
<a href="/docs/analytics/marketing-analytics"
class="no-underline inline-block text-[.875rem] p-2 leading-5 text-amp-gray-600">Use sessions, channels, and attribution to drive marketing analytics</a>
</div>
<div class="flex flex-row hover:bg-amp-gray-50 hover:rounded ">
<a href="/docs/analytics/ask-amplitude"
class="no-underline inline-block text-[.875rem] p-2 leading-5 text-amp-gray-600">Ask Amplitude</a>
</div>
</div>
</div>
<div class="absolute top-24 left-0 lg:left-64 bottom-0 right-0 z-0 transition">
<div class="max-w-screen-xl pt-8 mx-auto">
<section class="w-full flex flex-col items-center">
<div class="mr-2 text-s text-gray-500 "><a class=""
href="/docs/analytics">Analytics</a></div>
<span class="mr-2">/</span><div class="mr-2 text-s text-gray-500 "><a class="font-semibold"
href="/docs/analytics/amplitude-mcp">Amplitude MCP (Model Context Protocol) Server</a></div>
Amplitude MCP (Model Context Protocol) Server
<p>The Amplitude <a href="https://modelcontextprotocol.io/docs/getting-started/intro">Model Context Protocol (MCP)</a> 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.</p>
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 currently operates under fair use 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, 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(or use the EU URL from the Regions table if your data resides in the EU.)
-
Complete Amplitude OAuth authorization when prompted.
-
Start asking questions about your Amplitude data.
-
Add the MCP server globally:
claude mcp add -t http -s user Amplitude "https://mcp.amplitude.com/mcp" -
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/mcpinstead. -
Return to Tools & Integration tab and authenticate with Amplitude.
-
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/mcpinstead. -
Restart the MCP server and authenticate:
gemini/mcp auth amplitude
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.
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+Pon Mac,Ctrl+Shift+Pon 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.
</div>
</div>
<p class="text-xs text-amp-gray-600"><svg class="inline" xmlns="http://www.w3.org/2000/svg" width="20" height="21" viewBox="0 0 20 21" fill="none"><g id="schedule"><mask id="mask0_388_26358" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="20" height="21"><rect id="Bounding box" y="0.987793" width="20" height="20" fill="#D9D9D9"/></mask><g mask="url(#mask0_388_26358)"><path id="schedule_2" d="M12.7917 14.5295L13.8542 13.467L10.75 10.3628V5.98779H9.25V10.9878L12.7917 14.5295ZM10 18.9878C8.89756 18.9878 7.86153 18.7795 6.89192 18.3628C5.92231 17.9461 5.07292 17.3732 4.34375 16.644C3.61458 15.9149 3.04167 15.0645 2.625 14.0928C2.20833 13.1212 2 12.083 2 10.9783C2 9.8735 2.20833 8.83502 2.625 7.86279C3.04167 6.89057 3.61458 6.04335 4.34375 5.32113C5.07292 4.5989 5.92332 4.02946 6.89496 3.61279C7.86661 3.19613 8.90481 2.98779 10.0095 2.98779C11.1143 2.98779 12.1528 3.19779 13.1251 3.61779C14.0974 4.03779 14.9432 4.60779 15.6625 5.32779C16.3817 6.04779 16.9511 6.89446 17.3707 7.86779C17.7902 8.84113 18 9.88113 18 10.9878C18 12.0902 17.7917 13.1263 17.375 14.0959C16.9583 15.0655 16.3889 15.9149 15.6667 16.644C14.9444 17.3732 14.0963 17.9461 13.1223 18.3628C12.1482 18.7795 11.1075 18.9878 10 18.9878ZM10.0099 17.4878C11.8082 17.4878 13.3395 16.8524 14.6037 15.5815C15.8679 14.3107 16.5 12.7761 16.5 10.9779C16.5 9.17956 15.8679 7.64831 14.6037 6.38411C13.3395 5.1199 11.8082 4.48779 10.0099 4.48779C8.21165 4.48779 6.67708 5.1199 5.40625 6.38411C4.13542 7.64831 3.5 9.17956 3.5 10.9779C3.5 12.7761 4.13542 14.3107 5.40625 15.5815C6.67708 16.8524 8.21165 17.4878 10.0099 17.4878Z" fill="#5A5E68"/></g></g></svg> September 23rd, 2025</p>
Need help? Contact Support
Visit Amplitude.com
Have a look at the Amplitude Blog
Learn more at Amplitude Academy
</div>
<a href="https://www.linkedin.com/company/amplitude-analytics" class="mr-4" target="_blank">
<svg class="w-6 h-6 fill-amp-gray-600" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><g id="Icon"><path id="Vector" d="M19.7778 2C20.3671 2 20.9324 2.23413 21.3491 2.65087C21.7659 3.06762 22 3.63285 22 4.22222V19.7778C22 20.3671 21.7659 20.9324 21.3491 21.3491C20.9324 21.7659 20.3671 22 19.7778 22H4.22222C3.63285 22 3.06762 21.7659 2.65087 21.3491C2.23413 20.9324 2 20.3671 2 19.7778V4.22222C2 3.63285 2.23413 3.06762 2.65087 2.65087C3.06762 2.23413 3.63285 2 4.22222 2H19.7778ZM19.2222 19.2222V13.3333C19.2222 12.3727 18.8406 11.4513 18.1613 10.772C17.482 10.0927 16.5607 9.71111 15.6 9.71111C14.6556 9.71111 13.5556 10.2889 13.0222 11.1556V9.92222H9.92222V19.2222H13.0222V13.7444C13.0222 12.8889 13.7111 12.1889 14.5667 12.1889C14.9792 12.1889 15.3749 12.3528 15.6666 12.6445C15.9583 12.9362 16.1222 13.3319 16.1222 13.7444V19.2222H19.2222ZM6.31111 8.17778C6.80618 8.17778 7.28098 7.98111 7.63104 7.63104C7.98111 7.28098 8.17778 6.80618 8.17778 6.31111C8.17778 5.27778 7.34444 4.43333 6.31111 4.43333C5.81309 4.43333 5.33547 4.63117 4.98332 4.98332C4.63117 5.33547 4.43333 5.81309 4.43333 6.31111C4.43333 7.34444 5.27778 8.17778 6.31111 8.17778ZM7.85556 19.2222V9.92222H4.77778V19.2222H7.85556Z"/></g></svg>
</a>
<a href="https://twitter.com/Amplitude_HQ" class="mr-4" target="_blank">
<svg class="w-6 h-6 fill-amp-gray-600" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none"><g id="Frame 4824"><path id="Vector" d="M24 4.29446C23.1166 4.69598 22.1644 4.95985 21.1778 5.08604C22.1874 4.47801 22.9675 3.51434 23.3346 2.35564C22.3824 2.92925 21.327 3.33078 20.2141 3.56023C19.3078 2.57361 18.0344 2 16.5889 2C13.8929 2 11.6902 4.20268 11.6902 6.92161C11.6902 7.31166 11.7361 7.69025 11.8164 8.04589C7.73231 7.83939 4.0956 5.87763 1.67495 2.90631C1.25048 3.62906 1.00956 4.47801 1.00956 5.37285C1.00956 7.08222 1.86998 8.59656 3.20077 9.45698C2.38623 9.45698 1.62906 9.22753 0.963671 8.88337C0.963671 8.88337 0.963671 8.88337 0.963671 8.91778C0.963671 11.304 2.66157 13.3002 4.91013 13.7476C4.49713 13.8623 4.06119 13.9197 3.61377 13.9197C3.30402 13.9197 2.99426 13.8853 2.69599 13.8279C3.31549 15.7667 5.11664 17.2122 7.2849 17.2467C5.60994 18.5774 3.48757 19.3576 1.17017 19.3576C0.780115 19.3576 0.390057 19.3346 0 19.2887C2.17973 20.6883 4.77247 21.5029 7.54876 21.5029C16.5889 21.5029 21.5564 14 21.5564 7.49522C21.5564 7.27725 21.5564 7.07075 21.5449 6.85277C22.5086 6.16444 23.3346 5.29254 24 4.29446Z"/></g></svg>
</a>
<a href="https://www.g2.com/products/amplitude-analytics/reviews" class="mr-4" target="_blank">
<svg class="w-6 h-6 fill-amp-gray-600" xmlns="http://www.w3.org/2000/svg" width="21" height="20" viewBox="0 0 21 20"><g id="Frame 4825"><path id="path8" d="M11.0327 20C6.57742 19.9883 2.69803 17.1751 1.42954 12.9766C0.37117 9.45907 1.056 6.24504 3.43733 3.43569C4.90037 1.70805 6.78365 0.649677 9.00155 0.198312C10.2428 -0.0546084 11.5191 -0.0662816 12.7642 0.167183C12.9043 0.194421 12.9043 0.22944 12.8498 0.342281C12.2389 1.61466 11.628 2.89094 11.0249 4.16721C10.9938 4.24892 10.9121 4.29951 10.8226 4.29172C8.19999 4.35787 5.95874 6.20224 5.39064 8.76257C4.77975 11.4824 6.25057 14.2957 8.8498 15.2957C10.9121 16.0856 12.8265 15.7704 14.5736 14.4202C14.6631 14.354 14.6981 14.3385 14.7642 14.4513C15.4335 15.6225 16.1066 16.7899 16.7876 17.9572C16.8459 18.0584 16.8265 18.105 16.737 18.1673C15.4218 19.0973 13.9043 19.6926 12.309 19.9066C11.8809 19.9572 11.4568 19.9883 11.0327 20Z"/><path id="path10" d="M17.9512 17.105C17.8967 17.0739 17.8812 17.0155 17.8539 16.9649C17.0913 15.6497 16.3364 14.3345 15.5815 13.0155C15.5271 12.9065 15.4103 12.8404 15.2897 12.852C13.78 12.8559 12.2702 12.852 10.7605 12.852H10.5737C10.5737 12.7937 10.5932 12.7392 10.6321 12.6964C11.3986 11.3657 12.1652 10.031 12.9356 8.70027C12.9784 8.61078 13.0718 8.5563 13.173 8.56797C14.7177 8.57186 16.2664 8.57186 17.8111 8.56797C17.9084 8.5563 18.0018 8.61078 18.0446 8.70027C18.815 10.0427 19.5893 11.3851 20.3675 12.7275C20.422 12.7976 20.422 12.8949 20.3753 12.9688C19.5932 14.319 18.815 15.6653 18.0407 17.0155C18.0096 17.0427 18.0018 17.0894 17.9512 17.105Z"/><path id="path12" d="M14.6983 2.95331C14.422 2.67704 14.1613 2.41245 13.8967 2.15175C13.815 2.07004 13.8734 2.01167 13.9084 1.94941C14.2158 1.41634 14.7139 1.01945 15.3014 0.844348C16.0213 0.606992 16.8111 0.684814 17.4726 1.05836C18.675 1.70817 18.5699 3.2179 17.8734 3.90273C17.6088 4.15565 17.3131 4.36966 16.9862 4.54087C16.6516 4.71986 16.317 4.88718 15.9901 5.07784C15.7177 5.23348 15.5076 5.44749 15.4065 5.76267C15.3676 5.88718 15.3909 5.9222 15.5232 5.91831C16.4065 5.91442 17.2936 5.91831 18.1769 5.91442C18.3092 5.91442 18.3598 5.94166 18.3559 6.08563C18.3442 6.39691 18.3481 6.71209 18.3559 7.02338C18.3559 7.12065 18.3287 7.15567 18.2275 7.15567C16.8072 7.15178 15.3831 7.15178 13.9629 7.15567C13.8967 7.15567 13.8345 7.15567 13.8345 7.0584C13.8345 6.07395 14.0174 5.15566 14.7878 4.45527C15.1535 4.12842 15.566 3.85993 16.0096 3.6537C16.2547 3.53308 16.4999 3.42024 16.71 3.24903C16.8967 3.09728 17.0251 2.9144 17.0368 2.66537C17.0563 2.27626 16.7489 1.99222 16.2858 1.96109C15.6205 1.91439 15.1419 2.21401 14.8033 2.77043C14.7722 2.81712 14.7411 2.8716 14.6983 2.95331Z"/><path id="path14" d="M18.0869 18.5058V18.1828H17.9702V18.1167H18.2776V18.1828H18.1609V18.5058H18.0869ZM18.3321 18.5058V18.1167H18.4488L18.515 18.3813L18.5811 18.1167H18.6978V18.5058H18.6317V18.2023L18.5539 18.5058H18.4799L18.4021 18.2023V18.5058H18.3321Z"/></g></svg>
</a>
</div>
<div class="flex flex-col pr-8">
<div class="flex flex-row justify-between">
<a class="text-amp-gray-600 text-[0.875rem] font-[Gellix]" href="https://amplitude.com/terms" target="_blank">Terms of Service</a>
<a class="text-amp-gray-600 text-[0.875rem] font-[Gellix]" href="https://amplitude.com/privacy" target="_blank">Privacy Notice</a>
<a class="text-amp-gray-600 text-[0.875rem] font-[Gellix]" href="https://amplitude.com/aup" target="_blank">Acceptable Use Policy</a>
<a class="text-amp-gray-600 text-[0.875rem] font-[Gellix]" href="https://amplitude.com/legal" target="_blank">Legal</a>
</div>
<div><p class="text-[0.815rem] text-amp-gray-600 opacity-80 font-[Gellix]">© 2025 Amplitude, Inc. All rights reserved. Amplitude is a registered trademark of Amplitude, Inc.</p></div>
</div>
</div>
Server Config
{
"mcpServers": {
"Amplitude": {
"url": "https://mcp.amplitude.com/mcp",
"transport": "streamable-http"
}
}
}