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.
- In Amplitude copy the project API key and secret key
- In Ryze AI open Integrations, click Connect on the Amplitude card and enter the keys and data residency
- In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
- Start a new Cursor chat and ask about your events, funnels or retention
Cursor to Amplitude at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted MCP address, added to Cursor with a link or one entry in mcp.json |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in to the connector | In 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-in | The project API key and secret key, plus the data residency (us or eu). The key pair decides which project is connected |
| Amplitude tools | 1: amplitude__read, a read-only tool |
| Can it change Amplitude | No. The tool sends GET requests only, so it cannot create or edit charts, cohorts or events |
| Cursor plan needed | Cursor's MCP documentation names none |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Amplitude's own option for Cursor | Amplitude'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 connection | One Amplitude project per workspace connection |
| Last tested | No 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.
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.
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.
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" } } }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.
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
| Topic | What Cursor's documentation says |
|---|---|
| Config files | .cursor/mcp.json inside a project, or ~/.cursor/mcp.json for every project |
| Transports | stdio, SSE and Streamable HTTP |
| Sign-in | OAuth. 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 approval | Cursor 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 features | Tools, resources, prompts and elicitation |
| Where servers are managed | Customize in the sidebar. Team admins use Dashboard > Plugins & MCPs and Team Settings > MCP Configuration |
| Install link | cursor://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.
| Item | What it covers | With Ryze AI |
|---|---|---|
| API key and secret key of one project | Read access to the Dashboard REST API data of that project | Read only. The connector sends GET requests |
| Data residency us or eu | Which Amplitude region the requests go to | Set once when connecting |
| Event segmentation, funnels, retention | Charts you can build in Amplitude, returned as data | Read only |
| Active and new users, sessions, realtime | Usage counts for the project | Read only |
| User activity and user search | Event streams of one user and a search for users | Read only |
| Cohorts, annotations, saved chart results | Saved objects in the project, read by ID | Read 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.
| Tool | Type | What it does |
|---|---|---|
| amplitude__read | Read | Runs 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
| Limit | Number |
|---|---|
| Concurrent requests | Amplitude allows 5 concurrent requests per API key across the Dashboard REST API endpoints. |
| User activity and user search | These two endpoints share a further limit of 10 concurrent requests combined. |
| Hourly query cost | Up to 108,000 cost per hour. Every query costs at least 10. |
| Cost formula | Number of days times number of conditions times the cost of the query type. Long date ranges and many groups therefore cost more. |
| Event segmentation | Cost is the number of events, plus 4 for each group by. |
| Funnels | Cost is the number of events times 2, plus 4 for each group by per event. |
| Retention and sessions | Retention costs 8 and user sessions cost 4. Other endpoints cost 1. |
| When a limit is hit | Amplitude 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.
| Job | Ask Cursor | Tool | Works on the default connection |
|---|---|---|---|
| Event inventory | List the events in my Amplitude project. | amplitude__read | Yes |
| Event trend | Show daily uniques for one event over the last 30 days, grouped by one property. | amplitude__read | Yes |
| Funnel check | Read the funnel from the first to the last step of my signup flow for the last 14 days. | amplitude__read | Yes |
| Retention | Show retention for new users by week. | amplitude__read | Yes |
| Active users | Read active and new users for the last 7 days. | amplitude__read | Yes |
| Sessions and realtime | Read average sessions per user and the realtime active users. | amplitude__read | Yes |
| One user | Search for a user by ID and read that user's activity. | amplitude__read | Yes |
| Cohorts, annotations and saved charts | List my cohorts and annotations, then read the saved chart with a given chart ID. | amplitude__read | Yes |
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.
| Way | Runs where | Setup in Cursor | What it reaches in Amplitude | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted. One address for every user | The 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 key | One Amplitude project, read only: events, segmentation, funnels, retention, users, sessions, cohorts, annotations and saved chart results | Paid Ads is $89 per month with a 7-day free trial |
| Amplitude's own MCP server | Hosted by Amplitude at https://mcp.amplitude.com/mcp, EU at https://mcp.eu.amplitude.com/mcp | A 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 client | Amplitude's own MCP tools. Amplitude states that write operations need the Use MCP (write) RBAC action | Set 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
| Date | What happened |
|---|---|
| November 20, 2026 | Amplitude'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, 2026 | Amplitude'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, 2026 | Amplitude's Dashboard REST API page states 5 concurrent requests per API key and up to 108,000 cost per hour. |
| November 13, 2026 | Cursor'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 run | What came back |
|---|---|
| Amplitude's MCP documentation | Read on November 20, 2026. Source of the Amplitude server addresses, the Cursor config and the plan notes. |
| Amplitude's Dashboard REST API documentation | Read on November 20, 2026. Source of the endpoints, authentication and rate limit figures. |
| Ryze AI facts for the Amplitude tool | Taken 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 documentation | Read on November 13, 2026 for the config files, transports, sign-in and approval behavior. |
| Calls to the connector or to Amplitude | None. |
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.