How to connect Cursor to Amplitude

Connect one Amplitude project once in Ryze AI, add one MCP URL to Cursor, then ask Cursor about events, funnels, retention, cohorts and saved charts.

Your MCP URL
https://connector.get-ryze.ai/mcpAdd to Cursor

Copies the link and opens the Cursor install prompt for the ryze server. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Test record

Quick answer

The main way to connect Cursor to Amplitude is the Ryze AI connector. Connect your Amplitude project in Ryze AI with its API key, secret key and data residency, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json, and sign in when Cursor asks.

  1. In Amplitude copy the project API key and secret key
  2. In Ryze AI open Integrations, click Connect on the Amplitude card and enter the keys and data residency
  3. In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
  4. Start a new Cursor chat and ask about your events, funnels or retention

Cursor to Amplitude at a glance

FactDetail
Main way to connectThe Ryze AI connector: one hosted MCP address, added to Cursor with a link or one entry in mcp.json
Server addresshttps://connector.get-ryze.ai/mcp
Sign-in to the connectorIn the browser, through OAuth with PKCE. Cursor registers itself, so there is no client ID or secret to paste. A Ryze AI API key in a header also works
Amplitude sign-inThe project API key and secret key, plus the data residency (us or eu). The key pair decides which project is connected
Amplitude tools1: amplitude__read, a read-only tool
Can it change AmplitudeNo. The tool sends GET requests only, so it cannot create or edit charts, cohorts or events
Cursor plan neededCursor's MCP documentation names none
Ryze AI pricePaid Ads is $89 per month with a 7-day free trial. Adding the connector is free
Amplitude's own option for CursorAmplitude's own MCP server at https://mcp.amplitude.com/mcp (EU: https://mcp.eu.amplitude.com/mcp), with an OAuth sign-in to Amplitude
Projects per connectionOne Amplitude project per workspace connection
Last testedNo call to Amplitude was run for this guide. Facts checked November 20, 2026

Before you start

  • A Cursor install. Cursor's MCP documentation names no plan for using MCP servers. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
  • The API key and secret key of an Amplitude project. Copy them in Amplitude under Settings, Projects, the project, General. You also need to know whether the project is hosted in the US or the EU. The key pair decides which project Cursor reaches.
  • A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; SEO Starter is $129 per month with a 3-day free trial and Agency is $279 per month. The Amplitude tool works on any active plan or trial. Adding the connector is free, but the tool needs an active plan or trial.

How to connect Cursor to Amplitude

Two steps happen in Amplitude and Ryze AI, two in Cursor, and the last is your first prompt. The connector URL is the same for every user.

  1. Copy the project keys in Amplitude

    In Amplitude open Settings, Projects, the project, General, and copy the API key and the secret key. Note whether the project uses US or EU data residency.

  2. Connect Amplitude in Ryze AI

    Create a Ryze AI account or sign in, open Integrations, click Connect on the Amplitude card, fill in API key, Secret key and Data residency (us or eu), and click Continue.

  3. Add the Ryze AI server to Cursor

    Either use the Add to Cursor link on the Ryze AI developers page, which opens a cursor:// install link for a server named ryze at https://connector.get-ryze.ai/mcp, or create ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project) with the url entry shown below.

    { "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }
  4. Sign in from Cursor

    Confirm the install in Cursor. Cursor runs OAuth with PKCE and dynamic client registration, so there is no client ID or secret to enter. Sign in on the Ryze AI page and click Allow connection. You can manage or toggle the server from the Customize page in the sidebar.

  5. Ask your first question in Cursor

    Start a new chat in Cursor, approve the tool call when Cursor asks, and try: List the events in my Amplitude project.

The Ryze AI help center page for Amplitude covers the Amplitude side of the connection. Cursor does not have its own Ryze AI help page; the Ryze AI developers page has the Add to Cursor link and the matching config.

Sources: Cursor MCP documentation, Ryze AI Amplitude guide. Checked November 20, 2026.

mcp.json, API key and Cloud Agents

mcp.json

Save this as ~/.cursor/mcp.json for every project or .cursor/mcp.json for one project. Cursor accepts remote servers through the url field and handles the OAuth sign-in itself.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }

Cursor supports stdio, SSE and Streamable HTTP transports. For OAuth it reads the server's protected resource metadata (RFC 9728) and registers as a public client through dynamic client registration. After sign-in, manage or toggle the server from the Customize page in the sidebar.

mcp.json with a Ryze AI API key

If you prefer a key to the browser sign-in, add a headers entry and set RYZE_API_KEY in your environment to the rk_live_ key from Ryze AI under Workspace Settings > Profile > API keys. Keep the key out of files you commit.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp", "headers": { "Authorization": "Bearer ${env:RYZE_API_KEY}" } } } }

Connect Amplitude from Claude or ChatGPT instead

If you ask the Ryze AI agent in Claude or ChatGPT to connect Amplitude, it sends a one-time link, valid once and for 24 hours, to a page where you enter the keys and the data residency. Cursor does not take part in that step, so the simplest route for a Cursor user is the Integrations page in the Ryze AI app.

Cloud Agents

Cursor Cloud Agents keep their own MCP sign-ins on Cursor's servers, separate from the sign-in on your desktop. If a Cloud Agent needs your Amplitude data, connect the Ryze AI server for it as well.

Cursor and MCP: the facts in one table

TopicWhat Cursor's documentation says
Config files.cursor/mcp.json inside a project, or ~/.cursor/mcp.json for every project
Transportsstdio, SSE and Streamable HTTP
Sign-inOAuth. Cursor registers as a public client with no client secret. Static OAuth client credentials in mcp.json are the alternative
Variables in mcp.json${env:NAME}, ${userHome}, ${workspaceFolder}, ${workspaceFolderBasename} and ${pathSeparator}
Tool approvalCursor asks before it uses an MCP tool by default. In Auto-review mode, allowlisted MCP tools run at once and every other call goes through Cursor's review step
MCP featuresTools, resources, prompts and elicitation
Where servers are managedCustomize in the sidebar. Team admins use Dashboard > Plugins & MCPs and Team Settings > MCP Configuration
Install linkcursor://anysphere.cursor-deeplink/mcp/install, with the server name and a base64 copy of the config

Sources: Cursor MCP documentation, Cursor MCP install links. Checked November 20, 2026.

Claude and ChatGPT

The same URL works in other MCP clients. Amplitude is connected once in Ryze AI, so nothing changes on the Amplitude side.

Claude

Add https://connector.get-ryze.ai/mcp as a custom connector under Customize > Connectors, pick the workspaces and start a new chat. Claude has its own guide for Amplitude, linked below.

ChatGPT

Add the same URL as an app under Settings > Apps, pick the workspaces and start a new chat. If the connector was added before Amplitude was connected in Ryze AI, remove and re-add it so the tool list refreshes. ChatGPT has its own guide for Amplitude, linked below.

Amplitude access and keys

Two sign-ins are involved: Amplitude keys for project access and Ryze AI for the connector. Three things decide what Cursor can reach.

Which project
The Amplitude project whose API key and secret key you entered in Ryze AI. One workspace holds one Amplitude project. To switch projects, disconnect Amplitude from View in the Ryze AI app and connect again with the other project's keys.
Which region
The data residency you chose when connecting, us or eu. Amplitude hosts its Dashboard REST API for EU projects on a separate address, analytics.eu.amplitude.com.
What Cursor asks first
Cursor asks for approval before using MCP tools by default and follows the same Run Modes as terminal commands, so each Amplitude query waits for your click unless you allowlist the tool.

What the key pair covers

Amplitude does not use scopes or roles for this connection. It uses a key pair, and the pair belongs to one project. Amplitude's Dashboard REST API takes the API key as the username and the secret key as the password in HTTP Basic authentication.

ItemWhat it coversWith Ryze AI
API key and secret key of one projectRead access to the Dashboard REST API data of that projectRead only. The connector sends GET requests
Data residency us or euWhich Amplitude region the requests go toSet once when connecting
Event segmentation, funnels, retentionCharts you can build in Amplitude, returned as dataRead only
Active and new users, sessions, realtimeUsage counts for the projectRead only
User activity and user searchEvent streams of one user and a search for usersRead only
Cohorts, annotations, saved chart resultsSaved objects in the project, read by IDRead only

Not included: creating or editing charts, cohorts or events, because the tool is GET only. A second Amplitude project in the same workspace is also not included, because each connection covers one project.

Source: Amplitude Dashboard REST API. Checked November 20, 2026.

Removing access

To remove access, disconnect Amplitude in the Ryze AI app from View on the Amplitude card. In Cursor, toggle the ryze server off from Customize or delete its entry from mcp.json.

What Cursor can do in Amplitude

The Ryze AI connector exposes one Amplitude tool, and it is read-only. It sends a GET request to the Amplitude Dashboard REST API for the connected project.

ToolTypeWhat it does
amplitude__readReadRuns a read-only Amplitude Dashboard REST API GET request for the connected project: event list, event segmentation, funnels, retention, active and new users, sessions, realtime, user activity and search, cohorts, annotations and saved chart results.

Some limits apply to every client, Cursor included. The tool is GET only, so it cannot create or edit charts, cohorts or events. One connection covers one Amplitude project. Without an active Ryze AI plan or free trial, the connector can only list workspaces and connect platforms.

The only Amplitude tool is a read tool sent as GET, so the connector does not change anything in Amplitude. Cursor still asks before it runs an MCP tool by default; allowlist the tool if you do not want a click for each query. Separately, the Ryze AI chat has its own Tool approvals picker that defaults to Skip all approvals.

Limits in numbers

LimitNumber
Concurrent requestsAmplitude allows 5 concurrent requests per API key across the Dashboard REST API endpoints.
User activity and user searchThese two endpoints share a further limit of 10 concurrent requests combined.
Hourly query costUp to 108,000 cost per hour. Every query costs at least 10.
Cost formulaNumber of days times number of conditions times the cost of the query type. Long date ranges and many groups therefore cost more.
Event segmentationCost is the number of events, plus 4 for each group by.
FunnelsCost is the number of events times 2, plus 4 for each group by per event.
Retention and sessionsRetention costs 8 and user sessions cost 4. Other endpoints cost 1.
When a limit is hitAmplitude answers with HTTP 429 and says which limit was exceeded.

Source: Amplitude Dashboard REST API. Checked November 20, 2026.

First 3 prompts to run, and 8 jobs

1. List the events in the project

List the events in my Amplitude project and show which ones have the most uniques over the last 30 days.

Tools used: amplitude__read

What comes back: The event list and an event segmentation by uniques. Nothing is changed.

2. Read a funnel

Run a funnel for the events sign_up and purchase over the last 14 days and show the conversion between the steps.

Tools used: amplitude__read

What comes back: The funnel data for those two events as Amplitude reports it. Replace the event names with your own.

3. Check retention and saved charts

Show retention for new users over the last 8 weeks, then read the saved chart with ID my-chart-id.

Tools used: amplitude__read

What comes back: Retention data and the result of the saved chart. Replace the chart ID with one from your project.

No call to Amplitude was run for this page, so it shows no result tables and no metric values. Each prompt describes what comes back. Replace the event names and the chart ID with your own.

8 jobs to hand to Cursor

Eight jobs to hand to Cursor, each matched to the tool it uses. Every job is a read, because the Amplitude tool has no write access. None of them was run for this page.

JobAsk CursorToolWorks on the default connection
Event inventoryList the events in my Amplitude project.amplitude__readYes
Event trendShow daily uniques for one event over the last 30 days, grouped by one property.amplitude__readYes
Funnel checkRead the funnel from the first to the last step of my signup flow for the last 14 days.amplitude__readYes
RetentionShow retention for new users by week.amplitude__readYes
Active usersRead active and new users for the last 7 days.amplitude__readYes
Sessions and realtimeRead average sessions per user and the realtime active users.amplitude__readYes
One userSearch for a user by ID and read that user's activity.amplitude__readYes
Cohorts, annotations and saved chartsList my cohorts and annotations, then read the saved chart with a given chart ID.amplitude__readYes

2 ways to connect Cursor to Amplitude

There are two ways to give Cursor access to Amplitude that were checked for this guide. This guide uses the first one, the Ryze AI connector, as the main way: one hosted address and one project key pair. The second, Amplitude's own MCP server, was read in Amplitude's documentation on the same day and is listed with what it needs.

WayRuns whereSetup in CursorWhat it reaches in AmplitudePrice
Ryze AI connector (the main way)Hosted. One address for every userThe Add to Cursor link, or a url entry in mcp.json. Sign-in in the browser. The Amplitude project is connected once in Ryze AI with its API key and secret keyOne Amplitude project, read only: events, segmentation, funnels, retention, users, sessions, cohorts, annotations and saved chart resultsPaid Ads is $89 per month with a 7-day free trial
Amplitude's own MCP serverHosted by Amplitude at https://mcp.amplitude.com/mcp, EU at https://mcp.eu.amplitude.com/mcpA url entry in .cursor/mcp.json or ~/.cursor/mcp.json, or Amplitude's one-click install link. OAuth sign-in to Amplitude. Amplitude's page lists Cursor as a supported clientAmplitude's own MCP tools. Amplitude states that write operations need the Use MCP (write) RBAC actionSet by your Amplitude plan. Amplitude's page says service account sign-in is on Enterprise and an add-on for Plus, and that Free and Growth need to upgrade to use MCP

Two options that do not fit this job

  • Community servers and generic API wrappers. Anyone can write an MCP server that wraps the Amplitude REST API. Those were not opened for this guide, so no claim is made about them. Check the repository, its last commit and the scopes it asks for before you give it a secret key.
  • Amplitude exports and the Amplitude CSV download. Amplitude's saved chart endpoint can return CSV, but pasting exports into Cursor is manual work and not a connection.

Which one to pick

Ryze AI is the best way to connect Cursor to Amplitude for reading funnels, retention and saved charts with one key pair, with one caveat: it is read only and covers one project per workspace. Choose Amplitude's own MCP server when your Amplitude plan includes it and you want Amplitude's own tools and the option to write with the Use MCP (write) permission. You can run both in Cursor at the same time.

Sources: Amplitude MCP server documentation, Amplitude Dashboard REST API, Cursor MCP documentation, Ryze AI Amplitude guide. Checked November 20, 2026.

Amplitude and MCP: dates that matter

DateWhat happened
November 20, 2026Amplitude's MCP documentation lists Cursor among supported clients and gives the server address https://mcp.amplitude.com/mcp, with https://mcp.eu.amplitude.com/mcp for the EU.
November 20, 2026Amplitude's MCP documentation says write operations need the Use MCP (write) RBAC action, and that service account sign-in is on the Enterprise plan and an add-on for Plus.
November 20, 2026Amplitude's Dashboard REST API page states 5 concurrent requests per API key and up to 108,000 cost per hour.
November 13, 2026Cursor's MCP documentation, as read that day, describes mcp.json remote servers by url, OAuth with dynamic client registration and approval before MCP tool use by default.

Sources: Amplitude MCP server documentation, Amplitude Dashboard REST API, Cursor MCP documentation. Checked November 20, 2026 (Cursor page November 13, 2026).

How this guide was tested

No call to Amplitude, and no call to the Ryze AI connector, was run for this guide. The table lists what was done and what was not.

What was runWhat came back
Amplitude's MCP documentationRead on November 20, 2026. Source of the Amplitude server addresses, the Cursor config and the plan notes.
Amplitude's Dashboard REST API documentationRead on November 20, 2026. Source of the endpoints, authentication and rate limit figures.
Ryze AI facts for the Amplitude toolTaken from the Ryze AI app source and the Ryze AI help center as recorded on November 8, 2026. They list one tool, amplitude__read.
Cursor's MCP documentationRead on November 13, 2026 for the config files, transports, sign-in and approval behavior.
Calls to the connector or to AmplitudeNone.

Not run for this page: every step inside Cursor, every call of amplitude__read and any sign-in to Amplitude. The Amplitude tool name comes from the Ryze AI app source and was not seen in a live connected session. Because of that, this guide shows no tested reads, no results and no exact error messages.

Cursor and Amplitude errors and fixes

No exact error messages were captured, because no call to Amplitude was run for this guide. These are the problems that follow from the documented behavior.

Problems and fixes

The Amplitude tool does not appear in Cursor
If Amplitude was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new chat so the tool list refreshes.
Cursor never asks me to sign in
Open Customize in the sidebar, find the ryze server and reconnect it. Cursor reads the connector's protected resource metadata and registers itself, so no client ID is needed.
Amplitude rejects the keys
Copy the API key and secret key again from Settings, Projects, the project, General, and check that the data residency matches the project, us or eu.
Amplitude answers with HTTP 429
A limit was hit. Amplitude allows 5 concurrent requests per API key and a cost-based hourly cap. Ask Cursor for a shorter date range or fewer groups, then retry.
I need a different Amplitude project
Amplitude holds one connection per workspace. Disconnect it from View in the Ryze AI app and connect again with the other project's keys, or use another workspace.
The one-time connection link is refused
The link is refused while Amplitude is already connected in the workspace. Switch projects in the Ryze AI app instead.
A Cloud Agent cannot reach Amplitude
Cloud Agents keep their own MCP sign-ins on Cursor's servers. Connect the Ryze AI server for the agent separately from your desktop.
The server is blocked on a team account
Enterprise admins can allowlist which servers and tools the team may run. Ask an admin to allow the Ryze AI server in Team Settings > MCP Configuration.
The tool replies that a subscription is required
The Amplitude tool needs an active Ryze AI plan or free trial. Start the trial, then retry.
Cursor cannot change a chart or cohort
The tool is GET only, so it cannot create or edit charts, cohorts or events.

Terms on this page

MCP
The Model Context Protocol, an open standard for connecting AI applications to outside systems. Cursor, Claude and ChatGPT support it.
MCP server
A program that offers tools over MCP. The Ryze AI connector is an MCP server that runs on Ryze AI's side, so there is nothing to install.
mcp.json
The file where Cursor keeps its list of MCP servers.
Tool
One action that an MCP server offers. The Ryze AI connector has one for Amplitude, and it only reads.
API key and secret key
The pair Amplitude issues for each project. Together they are the login for the Dashboard REST API.
Data residency
The region where an Amplitude project stores its data, US or EU. Ryze AI asks for it when you connect.
Query cost
Amplitude's unit for how heavy a Dashboard REST API request is. A project has an hourly cost cap.

Source for MCP: modelcontextprotocol.io. Checked November 20, 2026.

Frequently asked questions

How do I connect Cursor to Amplitude?

Connect your Amplitude project in Ryze AI under Integrations by entering the API key, secret key and data residency. Then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link on the Ryze AI developers page or a url entry in mcp.json, and sign in when Cursor asks.

Is there an Amplitude MCP server for Cursor?

Yes, two. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 1 read-only Amplitude tool for your connected project. Amplitude also runs its own MCP server at https://mcp.amplitude.com/mcp, and its documentation lists Cursor as a supported client.

What is the Amplitude MCP server URL for Cursor?

For the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user. Amplitude's own server is https://mcp.amplitude.com/mcp, and https://mcp.eu.amplitude.com/mcp for EU projects.

Does Amplitude have an official MCP server?

Yes. Amplitude documents a hosted MCP server with an OAuth sign-in, and it lists Cursor, Claude Code, ChatGPT, Codex and other clients. Amplitude states that write operations need the Use MCP (write) RBAC action.

Which should I use, Ryze AI or Amplitude's own MCP server?

Ryze AI is the best way to connect Cursor to Amplitude for reading funnels, retention and saved charts with one key pair, with one caveat: it is read only and covers one project per workspace. Amplitude's own server suits teams whose Amplitude plan includes MCP and who want Amplitude's own tools. Both can run in Cursor at the same time.

Can Cursor change anything in Amplitude through Ryze AI?

No. The only Amplitude tool is amplitude__read, which sends GET requests, so it cannot create or edit charts, cohorts or events.

What can Cursor read from Amplitude?

Through amplitude__read, Cursor can list events, run event segmentation, read funnels and retention, read active and new users, average sessions and realtime data, look up a user's activity, search users, and read cohorts, annotations and saved chart results by chart ID.

Which Cursor plan do I need?

Cursor's MCP documentation names no plan. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration.

Which Amplitude keys do I need?

The project API key and secret key, found in Amplitude under Settings, Projects, the project, General, and the data residency of the project, us or eu. The key pair decides which project is connected.

Can I connect more than one Amplitude project?

One workspace holds one Amplitude connection, which covers one project. To switch, disconnect Amplitude in the Ryze AI app and connect again with the other project's keys. Another project can live in another workspace.

What are the Amplitude rate limits?

Amplitude's Dashboard REST API allows 5 concurrent requests per API key and up to 108,000 cost per hour. User activity and user search share a further limit of 10 concurrent requests. Amplitude answers with HTTP 429 when a limit is exceeded.

Why does the Amplitude tool not show up in Cursor?

If you connected Amplitude in Ryze AI after adding the server, remove the ryze entry from Cursor, add it again and start a new chat so the tool list refreshes.

How much does it cost to connect Cursor to Amplitude?

Adding the connector costs nothing, but the Amplitude tool needs an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year.

How do I disconnect Amplitude from Cursor?

Disconnect Amplitude in the Ryze AI app, or toggle the ryze server off from Customize in Cursor, or delete its entry from mcp.json.

Connect Amplitude to Cursor

Your Amplitude project connects once in Ryze AI, then Cursor reads events, funnels, retention, cohorts and saved charts. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Amplitude MCP server

Need help? Read the Ryze AI help center page for Amplitude or email Ryze AI support.