← Guides·Analytics MCP servers

Analytics MCP servers

Amplitude MCP server: setup, tools and write access

Connect Amplitude’s official MCP server to Claude, Cursor or Codex, see which tools it exposes and what it can change, and what it can’t see in your data.

David PombarSwiss army knife at Trackingplan
8 min read · 1725 words

TL;DR The Amplitude MCP server is Amplitude’s own hosted server at https://mcp.amplitude.com/mcp (EU: https://mcp.eu.amplitude.com/mcp). You add the URL to Claude, Cursor, Codex or another MCP client and sign in with OAuth: no API key. It reads and writes charts, dashboards, cohorts, experiments, flags and your tracking plan, with your own permissions. It doesn’t ingest events. And it hands the assistant whatever Amplitude stored, including events your app sent wrong.

This guide is part of our series on analytics MCP servers. It covers what Amplitude’s server is, how to connect it, what each group of tools does, what it can change, and the one thing no setup fixes: the assistant reads the data as Amplitude received it.

What is the Amplitude MCP server?

It’s an official MCP server that Amplitude runs for its customers. Your AI client connects to it over streamable HTTP, you sign in with your Amplitude account, and the client can then query and edit your Amplitude content in plain language.

The facts that matter before you connect, all from Amplitude’s docs:

Amplitude MCP
PublisherAmplitude (official). Listed in the MCP Registry as com.amplitude/mcp-server
Where it runsHosted by Amplitude, remote
TransportStreamable HTTP
URLhttps://mcp.amplitude.com/mcp (US), https://mcp.eu.amplitude.com/mcp (EU)
AuthOAuth with your Amplitude account; service accounts for unattended agents
ReadsCharts, dashboards, notebooks, cohorts, experiments, flags, events, properties, user profiles, session replays
WritesCharts, dashboards, notebooks, cohorts, experiments, flags, metrics, tracking plan
Doesn’tIngest events, publish guides or surveys, manage custom agents

Amplitude also runs a second, separate server for its public documentation, at https://amplitude.com/docs/api/mcp. It needs no sign-in, it’s read-only and it has three tools. If someone on your team says they “added the Amplitude MCP” and it only answers how-to questions, that’s the one they added.

Diagram of the Amplitude MCP server: what it reads from your Amplitude projects, what it can write with the Use MCP (write) permission, and what it doesn’t do, such as ingesting events or seeing data that never reached Amplitude
Diagram of the Amplitude MCP server: what it reads from your Amplitude projects, what it can write with the Use MCP (write) permission, and what it doesn’t do, such as ingesting events or seeing data that never reached Amplitude

How to connect it

Every client connects to the same URL and signs in the same way. If your data is in the EU, swap in the EU URL everywhere below. Amplitude also lets you start the connection from its own app, at Settings > Connections > MCP.

Claude Code

Amplitude documents this command, which adds the server for your user account in every session:

claude mcp add --transport http --scope user Amplitude https://mcp.amplitude.com/mcp

Then start claude, run /mcp, select Amplitude and finish the OAuth flow in the browser. With --scope project instead, Claude Code writes a .mcp.json file you can commit for the whole repository, and asks each person to approve the server the first time.

Claude (web and desktop)

Amplitude is a listed connector in Claude’s directory, so there’s no URL to paste. Open Settings > Connectors, select Browse, search for Amplitude and complete the sign-in. On Team and Enterprise plans an owner enables the connector first; then each member connects their own Amplitude account.

Cursor and Codex

In Cursor, add the server to .cursor/mcp.json in a project or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "Amplitude": {
      "url": "https://mcp.amplitude.com/mcp"
    }
  }
}

Then select Connect or Needs login next to Amplitude in Cursor Settings > Tools & Integrations. In Codex, one command writes the config and opens the sign-in:

codex mcp add amplitude --url https://mcp.amplitude.com/mcp

To check any of them, ask: “What Amplitude projects can I access?” A list of your projects means the connection works. Sign in to only one Amplitude organization during the flow: Amplitude warns that being signed in to several can make it fail.

The tools it exposes

Amplitude’s catalog is long, and it grows. These are the groups that matter for analytics work:

GroupToolsWhat they do
Discovery and contextsearch_amp_entities, search_amp_data_taxonomy, get_from_url, get_amplitude_contextFind content and events, read your org and project settings and AI Context
Chartsquery_amplitude_data, get_amplitude_charts, render_amplitude_chart, use_amplitude_chart_monitorsAd-hoc segmentation, funnels and retention; saved charts; chart alerts
Dashboards and notebooksuse_amp_dashboards, use_amp_notebooksRead, create and rearrange
Cohortsuse_amplitude_cohortsCreate, check membership, sync to destinations such as Braze or a webhook
Experiments and flagsuse_amp_experiments, use_amp_flags, use_amplitude_metricsAnalyze variants, create tests and flags, define metrics
Taxonomyget_amp_taxonomy, manage_amp_events, manage_amp_properties, manage_amp_branchesRead and change the tracking plan, branch by branch
Users and replaysget_amp_user_data, get_amp_session_replay_infoUser timelines; replays from the last 30 days
Data warehouseuse_amplitude_data_connections, get_data_warehouse_destinationsImport sources, export destinations, job history

There are more for feedback, AI Visibility, Wave and agent analytics, plus run_amp, a passthrough to Amplitude’s Developer API for jobs no dedicated tool covers.

Two settings change how the tools reach the model. ChatGPT gets a curated subset by default. And ?discovery=progressive at the end of the URL starts the session with a small list of discovery tools and loads the rest on demand, the setting Amplitude suggests to cut token spend.

Start every session with get_amplitude_context. It returns the AI Context your team wrote in AI Controls (metric definitions, terminology, business rules), so the model uses your definitions rather than its own guesses.

What it can change, and how to keep it read-only

The server acts as the person who signs in. It reaches the projects that person can reach, with that person’s role, and nothing more. Within that, it writes.

Amplitude gives admins two levers. At the organization level, the server is on by default and can be blocked under Settings > Content Access, in the Model Context Protocol tab. At the project level, roles carry two actions, Use MCP (read) and Use MCP (write). Viewer roles get read; Member, Manager and Admin get both. Remove the write action from a role and its MCP calls fail on write, even for an org admin. For an analyst who should only ask questions, that’s the setting.

Limits worth knowing

What the assistant can’t see from Amplitude

Every tool above reads what Amplitude stored. That’s the limit no permission setting changes. If a release dropped a property from Purchase Completed, the model sees purchases without it. If the app fires the event twice on one screen, the model counts two purchases and calls the funnel healthy. If the event stopped firing on Android, there’s nothing in Amplitude to read, so there’s nothing to flag.

Amplitude’s taxonomy tools help on their side: they show unexpected events that reached your project and let you add them to the plan. They work on what arrived. What your app sent, to Amplitude and to every other platform, is a different source.

That’s the source Trackingplan reads. It watches the requests your website and your iOS and Android apps send to analytics and ad platforms, Amplitude among them, along with the dataLayer and the consent signals, on real traffic. Missing properties, dead tags, duplicate fires and orphan events are caught as they appear. Its agent answers from that evidence, shows the queries behind every answer, and adds a data quality note when an open issue changes the number.

Trackingplan MCP brings that into the same client as Amplitude’s server. Ask Claude for last week’s checkout funnel from Amplitude, then ask Trackingplan whether Purchase Completed fired correctly on every platform that week. Each person signs in as themselves, with no API key (setup in the docs), and any change to the plan waits for your approval. An AI agent can only reason about what it can see. Validate the data before you hand it to one.

For how Amplitude’s server compares with PostHog’s and Mixpanel’s, job by job, see PostHog vs Mixpanel vs Amplitude MCP.

FAQ

What is the Amplitude MCP server?

It’s Amplitude’s official, hosted MCP server. Any MCP client, such as Claude, Cursor, Codex or ChatGPT, connects to it over streamable HTTP, signs in with your Amplitude account through OAuth, and can then query, create and edit charts, dashboards, cohorts, experiments, feature flags and tracking plan events in the projects you can access.

Is the Amplitude MCP free?

Amplitude’s docs say any existing Amplitude customer can use it from an MCP client. Service accounts, for agents that run without a person signing in, are included in the Enterprise plan and sold as an add-on on Plus.

Can I make the Amplitude MCP read-only?

Yes, per role. Amplitude has two role actions, Use MCP (read) and Use MCP (write). Give someone a role without the write action on a project and every write call from their MCP client fails there, even for an org admin. Admins can also block the server for the whole organization.

Can I send events to Amplitude through the MCP server?

No. Amplitude says the MCP isn’t an ingestion endpoint. Events go through an Amplitude SDK or the HTTP V2 API. The manage_amp_events tool registers event definitions in the tracking plan; it doesn’t send event data.

Does the Amplitude MCP work with EU data?

Yes, through its own URL, https://mcp.eu.amplitude.com/mcp. The URL has to match the region where your data lives, or sign-in fails. The Amplitude connector in Claude’s directory uses the US server, so EU customers contact their Amplitude account team before connecting it.

David PombarSwiss army knife at Trackingplan

Read more from David, a Senior Product Strategist with 18+ years in digital product development and an atypical error detection knack.

Trackingplan

See everything. Miss nothing.

Your implementations audited around the clock with real-time, real-user data. Real-time alerts about errors or changes in your data, campaigns, pixels, privacy and consent. Let AI flag issues before they cost you.