How to Connect Amplitude to Cursor via MCP

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → Amplitude, paste your credentials, mint an MCP API key and you're done. No Docker, no git clone, no local server.

Amplitude + Cursor

Let your AI read your Amplitude product analytics: event trends, funnels, retention, active and new users, revenue LTV, sessions, saved charts, cohorts, user lookups and the tracking plan, and add chart annotations. US and EU data centers.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

AMPLITUDE_API_HOST, AMPLITUDE_API_KEY, AMPLITUDE_SECRET_KEY

Step 1 — Get credentials

1. You need the Manager or Admin role in the Amplitude project. Select Settings (lower left), then Projects, and pick the project. Each project has its own keys, so one connector reads one project.
2. On the project's General tab, select Manage next to API Key and copy the key into AMPLITUDE_API_KEY.
3. Select Manage next to Secret Key and generate a new secret key for AnythingMCP. Amplitude shows a secret key only once, when it is generated, so paste it into AMPLITUDE_SECRET_KEY straight away. A project can have several secret keys.
4. Set AMPLITUDE_API_HOST to the project's data center: https://amplitude.com for the default (US) data center, https://analytics.eu.amplitude.com for an EU project (its app runs on app.eu.amplitude.com). Keys of an EU project are refused on the US host and the other way round. analytics.amplitude.com is the web app, not the API.
5. Install the connector and run amplitude_list_events to see the exact event names your project tracks.

Who sees what: the secret key reads every event and user of the project. Share the MCP server only with people allowed to see that data.

What it reads: event trends with filters and group bys, funnels, retention, active and new users (also live, in 5-minute steps), revenue LTV, session length and sessions per user, user composition, the results of charts saved in Amplitude (found by the id after /chart/ in the chart's address), behavioral cohorts, user lookups with a user's recent events, and the tracking plan (event types, event and user properties, categories). Dates are whole days in the project's time zone. The cohort list needs the Behavioral Cohorts add-on on Growth or Enterprise.

Limits: Amplitude's limits apply per project and are shared with every other integration. The Dashboard REST API runs at most 5 requests at the same time and has a query cost budget of 1,000 per 5 minutes and 108,000 per hour. A query costs the days in the range times the conditions (segments and filters; each group by counts 4) times the chart cost (segmentation 1 per event, funnels 2 per step, retention 8, sessions 4, everything else 1). User search and user activity have their own limit of 10 at the same time and 360 per hour, and the tracking plan allows 7,200 reads per hour. Above a limit Amplitude answers 429: the AI waits, and shortens the range or drops group bys when the cost budget is the problem. One query with a group by replaces many day-by-day or user-by-user queries.

Personal data: amplitude_search_users and amplitude_get_user_activity return a user's profile and events. The AI uses them for the user you ask about.

Confirm first: an annotation without a chart shows on every chart of the project for every member, so the AI confirms the label, time and scope with you before amplitude_create_annotation. amplitude_delete_annotation is switched off at install.

Common errors: 403 "Invalid API Key": the key or secret is wrong, belongs to another project, or the project lives in the other data center (check AMPLITUDE_API_HOST). 401: one of the two keys is missing. 400: a parameter or the JSON of an event or segment is invalid, or a saved chart belongs to another project. 404 on amplitude_get_chart_results: there is no saved chart with that id. 429: a concurrency, hourly or cost limit is reached, and Amplitude says which.

The connector does not send events into Amplitude, export raw event files, download or upload cohorts, delete users for privacy requests, or cover Experiment, Session Replay or user management.

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Cursor

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Cursor reads MCP servers from ~/.cursor/mcp.json. Add this entry:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of YOUR_MCP_API_KEY.
2. Save the file and restart Cursor.
3. Open Cursor → Settings → MCP and check that anythingmcp is listed and connected.
4. Start chatting: the agent can now call the Amplitude tools.

Available tools

Example prompts

• "How many users did Sign Up each week over the last three months, grouped by country?"
• "Show me the funnel from Sign Up to Create Project to Invite Teammate for September and the step where most users drop off."
• "Of the new users who started in August, how many came back in each of the following eight weeks?"
• "Add an annotation for the pricing page relaunch on 1 October to every chart, and show me the label and date before you save it."

FAQ

Does Cursor support custom MCP servers on the free tier? Yes, MCP is available on Hobby, Pro and Business plans.

Next steps

• Connector landing page
• Connect to Claude
• Connect to ChatGPT