MCP Directory

How to add Amplitude MCP to Windsurf

Amplitude's hosted MCP server — query charts, dashboards, experiments, flags, and session replays in plain English. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 45★ · http · oauth · official

Windsurf config for Amplitude MCP

claude mcp add --transport http amplitude https://mcp.amplitude.com/mcp
{
  "mcpServers": {
    "amplitude-mcp": {
      "serverUrl": "https://mcp.amplitude.com/mcp"
    }
  }
}

Remote server — no local install needed. Restart the client after saving the config.

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the Amplitude MCP config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5Amplitude MCP's tools become available to Cascade.

Before you start

  • An Amplitude account with access to at least one project
  • Appropriate project permissions in Amplitude — the server can't show anything your user can't see
  • An MCP client that supports remote HTTP servers with OAuth (Claude, Cursor, ChatGPT, etc.)

What Amplitude MCP can do in Windsurf

search

Find dashboards, charts, notebooks, and experiments

query_chart

Retrieve data from specific charts

query_experiment

Analyze experiment results and statistical significance

query_dataset

Execute custom analytics queries

query_metric

Get data for specific metrics

get_charts

Retrieve full chart definitions

get_dashboard

Access dashboard content and layout

get_notebook

Fetch notebook content with charts and analysis

Security

Auth is OAuth 2.0 scoped to your existing Amplitude permissions — there is no API key to store, and organization admins can control MCP server access. Your analytics data is processed by whichever third-party AI model your client uses, so check your org's AI data-processing policy before connecting.

Amplitude MCP + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Amplitude MCP config there under the "mcpServers" key and restart the client.

Is Amplitude MCP safe to use with Windsurf?

Auth is OAuth 2.0 scoped to your existing Amplitude permissions — there is no API key to store, and organization admins can control MCP server access. Your analytics data is processed by whichever third-party AI model your client uses, so check your org's AI data-processing policy before connecting.

Is the Amplitude MCP server free and safe to connect?

It's included with your Amplitude account — no separate charge is documented, though the beta may enforce rate limits. Access is OAuth-scoped to your existing permissions and admins can disable MCP org-wide; the main consideration is that query results flow through your AI client's model, so review your data-processing policy.

Do I need an API key?

No. Authentication is OAuth 2.0 — the client opens a browser login and tokens are managed for you. That also means agent access always follows a real Amplitude user, not a shared key you'd have to rotate.

Which endpoint should EU customers use?

https://mcp.eu.amplitude.com/mcp. The server URL must match your org's data residency region — pointing an EU org at the US endpoint results in authentication/connection errors.

View repo Full Amplitude MCP page