By Ira Bodnar, Ryze AI · Updated · No calls run: how this was checked
Quick answer
The main way to connect Cursor to Semrush is the Ryze AI connector. Paste your Semrush API key on the Semrush card in Ryze AI, 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 to Ryze AI when Cursor asks.
- In Semrush open Subscription info, API units tab, and copy the API key
- In Ryze AI open Integrations, click Connect on Semrush, paste the key and click Continue
- 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 a domain, its keywords or its backlinks
Cursor to Semrush at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector: one hosted address, added to Cursor by an install link or a url entry in mcp.json |
| Connector address | https://connector.get-ryze.ai/mcp |
| What Semrush needs | Your own API key from Subscription info, API units tab, on a Semrush plan with API access. The key is saved in Ryze AI and is never put in Cursor's files |
| How Cursor signs in | OAuth to Ryze AI with PKCE and dynamic client registration. A Ryze AI API key in a header is the alternative |
| Semrush tools | 1: semrush__read, a read-only Semrush Analytics API tool that also lists projects and reads Position Tracking reports |
| Can Cursor change Semrush | No. The only Semrush tool reads, so it cannot create or edit Position Tracking campaigns |
| What it costs in Semrush | Every call draws on your own Semrush API-unit balance. Ryze AI credits do not pay for it |
| Cursor plan | Cursor's MCP documentation names no plan. Enterprise admins can control which MCP servers users may run |
| Ryze AI price | $129 per month for SEO Starter after a 3-day free trial. The tool also works on Paid Ads at $89 per month. Adding the connector costs nothing |
| Semrush's own option for Cursor | Semrush's MCP server at https://mcp.semrush.com/v2/mcp, with a Cursor config in Semrush's docs. It signs in to Semrush by OAuth or an Apikey header |
| Last tested | No step inside Cursor and no Semrush call was run for this guide |
Before you start
- Cursor. Cursor's MCP documentation names no plan for adding a remote server. If you work in a Cursor Enterprise team, an admin can control which MCP servers you may run, so ask them first if the Ryze AI server is blocked.
- A Semrush API key. Ryze AI asks for one value, the API key, found in Semrush under Subscription info, API units tab. It needs a Semrush plan with API access, and every call uses the API units on that account.
- A Ryze AI workspace on a plan or free trial. SEO Starter is $129 per month with a 3-day free trial, which suits Semrush because the data is SEO data. The Semrush tool also works on Paid Ads ($89 per month, 7-day free trial) and Agency ($279 per month). Connecting the connector is free; without an active plan or trial, Cursor can only list workspaces and connect platforms.
How to connect Cursor to Semrush
Two steps happen in Semrush and Ryze AI, two in Cursor, and the last is your first prompt. The connector URL is the same for every user.
Copy the API key in Semrush
In Semrush open Subscription info and go to the API units tab. Copy the API key and keep it out of chats, commits and screenshots, because anyone holding it can spend your API units.
Connect Semrush in Ryze AI
In the Ryze AI app open Integrations, click Connect on the Semrush card, paste the key into API key and click Continue. One workspace holds one Semrush key.
Add the Ryze AI server to Cursor
The quick route is the Add to Cursor button above, or on the Ryze AI developers page: it opens a cursor:// install link for a server named ryze. The manual route is a url entry in mcp.json, shown below. Confirm the install in Cursor.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Sign in to Ryze AI
Cursor starts the OAuth sign-in. On the Ryze AI page sign in, pick the workspace that has Semrush and click Allow connection. Manage or toggle the server later from the Customize page in the sidebar.
Start a new chat and ask your first question
Open a new Cursor chat so the tool list includes Semrush. Try: Which organic keywords does the domain I name rank for in the US database, and which organic competitors does it have?
The Ryze AI help center page for Semrush covers the Semrush 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 Semrush guide. Checked November 21, 2026.
mcp.json, API key and Cloud Agents
mcp.json
Save this as ~/.cursor/mcp.json to have the server in every project, or as .cursor/mcp.json inside one project. The url field is how Cursor takes a remote server, and Cursor runs 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
To skip 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. This is a Ryze AI key, not your Semrush key, and it should stay out of files you commit.
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:RYZE_API_KEY}"
}
}
}
}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 should read Semrush 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 |
| Remote servers | An entry under mcpServers with a url, plus an optional headers object |
| 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; Enterprise admins can set an MCP allowlist |
| Install link | cursor://anysphere.cursor-deeplink/mcp/install, with the server name and a base64 copy of the config |
| Plan | The MCP page names no plan |
Sources: Cursor MCP documentation, Cursor MCP install links. Checked November 13, 2026.
Claude and ChatGPT
The same URL works in other MCP clients. Semrush is connected once in Ryze AI, so nothing changes on the Semrush side.
Claude
In Customize, Connectors, add a custom connector with https://connector.get-ryze.ai/mcp and finish the Ryze AI sign-in. Semrush stays connected once in Ryze AI, so nothing changes on the Semrush side. See the Claude guide for the steps.
ChatGPT
OpenAI documents custom MCP servers with full access on ChatGPT Business and Enterprise/Edu, and read and fetch only on Pro. Add the same URL as a custom MCP server with OAuth. The ChatGPT guide has the details.
Semrush access and cost
Semrush access comes from the API key you save in Ryze AI, and Cursor reaches Semrush only through it. Three things decide what Cursor can see and spend.
- Which key
- The one you pasted on the Semrush card. One Ryze AI workspace holds one Semrush key, and another Semrush account can live in another Ryze AI workspace.
- What the key spends
- Your Semrush API units. Treat the key like a password, because whoever holds it can use your balance. Disconnecting the card in Ryze AI cuts Cursor off.
- What Cursor asks first
- Cursor asks before it uses an MCP tool by default. Because the only Semrush tool reads, nothing in Semrush changes whether you approve or not.
What the connection uses
The Ryze AI connection uses an API key from your Semrush subscription, so there are no OAuth scopes to tick. This table lists what the connection uses.
| Item | What it covers | Source |
|---|---|---|
| API key | Authorizes each request and bills it to your account's API-unit balance. Found under Subscription info, API units tab | Ryze AI help center |
| Plan with API access | Required before the key works. Without it Ryze AI cannot read data | Ryze AI help center |
| API-unit balance | Every call draws on it. At zero, Semrush returns ERROR 132 or 403 depending on the API, and only you can top it up | Semrush API units docs |
| Regional database | Domain and keyword reports are asked for one regional database, such as US or UK | Ryze AI help center |
Not covered by the Ryze AI Semrush tool: creating or editing Position Tracking campaigns, because the tool only reads. Domain, keyword and backlink reports come back as CSV text that Cursor parses, and each report type needs its own parameters.
Source: Semrush API units balance, Ryze AI Semrush guide. Checked November 21, 2026.
Removing access
To remove access, click View on the Semrush card in Ryze AI and disconnect with the trash icon. In Cursor, toggle the ryze server off or remove it from Customize or mcp.json.
What Cursor can do in Semrush
The Ryze AI connector exposes one Semrush tool, and it only reads. The Ryze AI facts list it by name from the app source; it was not seen in a live tool list.
| Tool | Type | What it does |
|---|---|---|
| semrush__read | Read | Runs a read-only Semrush Analytics API request: domain overview, organic keywords, organic competitors, keyword overview, backlinks overview, referring domains, anchors and backlinks. It also lists projects and reads Position Tracking reports. |
Semrush publishes how units are charged. Its documentation gives no per-key request cap for the standard API beyond the units, and Cursor's MCP page states no limit on tools or servers.
Cursor asks before it uses an MCP tool by default, so you can watch each Semrush request before it runs and see the report it asks for. Separately, the Ryze AI chat has its own Tool approvals picker that starts on Skip all approvals.
Limits in numbers
| Limit | Number |
|---|---|
| Semrush API-unit balance | Every call spends units from your own balance. When units run out, SEO, Trends and Projects API calls return ERROR 132 or a 403, and some reports may return only as many lines as the balance allows |
| Per-line reports | Charged by the data returned, such as domain reports. A display limit keeps the cost down |
| Fixed-cost reports | Charged per request whatever comes back, such as the backlinks overview |
| Empty results | A request that returns no data uses no units |
| Balance check | Free, in Subscription info, API units tab, or by a free Standard API call |
| Semrush's own MCP server | A minimum of 50,000 MCP API units per monthly billing cycle, depending on plan, per Semrush's MCP page |
| Ryze AI connection | One Semrush key per workspace, and one connection can cover up to 20 workspaces |
| Tools or servers in Cursor | Not stated on Cursor's MCP page |
Sources: Semrush API units balance, Cursor MCP documentation. Checked November 21, 2026.
First 3 prompts to run
1. See what a domain ranks for
For the domain I name, list 20 organic keywords from the US database with position, monthly search volume, CPC and landing URL.
Tools used: semrush__read
What comes back: An organic keywords report for that domain, limited to the columns and rows you named. A short row limit spends fewer units. Semrush data stays unchanged.
2. Spot organic rivals
Which sites compete with the domain I name in organic search, and which two are worth studying first?
Tools used: semrush__read
What comes back: The organic competitors list as Semrush gives it, followed by Cursor's reading of which rivals matter.
3. Review who links to a site
Read the backlinks overview and Authority Score for the domain I name, then its referring domains and the anchors used most.
Tools used: semrush__read
What comes back: An overview first, then referring domain and anchor reads. Each one is its own request and spends its own units.
What comes back depends on the domain, so this page prints no sample figures. Give Cursor the domain, the country database and the number of rows you want.
10 jobs to hand to Cursor
Ten requests for Cursor, each with the tool behind it. Nothing below was run for this page; the last row is something this connection cannot do.
| Job | Ask Cursor | Tool | Works on the default connection |
|---|---|---|---|
| Size up a site | Pull the Semrush overview for example.com in the US database. | semrush__read | Yes |
| Top rankings | Show the organic keywords where this domain holds a position, with traffic. | semrush__read | Yes |
| Find rivals | Name the sites that compete with this domain for the same organic searches. | semrush__read | Yes |
| Check phrases | Return volume, CPC and competition for these five phrases in the UK database. | semrush__read | Yes |
| Link strength | Read Authority Score and the backlink totals for this domain. | semrush__read | Yes |
| Who links in | List the referring domains pointing at this site. | semrush__read | Yes |
| Anchor mix | Show the anchor texts that other sites use when linking here. | semrush__read | Yes |
| Link by link | Pull a sample of individual backlinks for this domain. | semrush__read | Yes |
| Rank tracking reports | List my Semrush projects and read the Position Tracking report of one campaign. | semrush__read | Yes, reports only |
| Start a new campaign | Create a Position Tracking campaign for this domain. | none | No. The tool only reads |
3 ways to connect Cursor to Semrush
Three ways put Semrush in front of Cursor. This guide treats the first as the main way: your Semrush key stays inside Ryze AI, Cursor needs one address, and the tool only reads. The other two come from Semrush's documentation, read on November 21, 2026. None of them was run for this guide.
| Way | Runs where | Setup in Cursor | What Cursor reaches in Semrush | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user | Add to Cursor link or a url entry in mcp.json for https://connector.get-ryze.ai/mcp, then an OAuth sign-in to Ryze AI | Your key's account, through one read tool for domain, keyword and backlink reports, projects and Position Tracking reports | SEO Starter is $129 per month with a 3-day free trial; Semrush API units are billed by Semrush |
| Semrush's own MCP server | Semrush's hosted server at https://mcp.semrush.com/v2/mcp, streamable HTTP only | Semrush's docs give a mcpServers entry with that url, added under Settings, Cursor Settings, Tools & MCP. Sign-in is OAuth in the browser, or an Authorization: Apikey header | Read-only Trends API, SEO API and Projects API methods, per Semrush. Semrush says it cannot create projects or change settings | Needs an active Semrush plan such as Semrush One Starter or Pro+, SEO Classic Pro or Guru, or a plan with an API units package. Semrush states a minimum of 50,000 MCP API units per monthly cycle |
| Semrush API from your own script | Your code calls the Semrush Analytics API | Nothing in Cursor itself. You write or ask Cursor to write the requests | Whatever the API allows for your key | Same API units as the other ways |
Two options that do not fit this job
- Semrush's Claude directory connector. It is built for Claude and does not apply to Cursor. Cursor takes the general server address instead.
- A community Semrush MCP server run on your machine. It would need its own install and your API key in a local file. This guide did not check any, so none is recommended or ruled out.
Which one to pick
Ryze AI is the best way to connect Cursor to Semrush when you want your API key kept out of Cursor's config and one address for other Ryze AI platforms, with one caveat: Semrush's own server covers more report families than the single Ryze AI read tool, such as site audit and traffic data. Pick Semrush's server when you want those under your own Semrush login. Pick the Ryze AI connector when Cursor should read domain, keyword and backlink data with a key you control. Both can sit in mcp.json at the same time.
Sources: Semrush MCP server docs, Semrush MCP page, Cursor MCP documentation, Ryze AI Semrush guide. Checked November 21, 2026.
Semrush, Cursor and MCP: dates that matter
| Date | What happened |
|---|---|
| November 21, 2026 | Semrush's MCP documentation lists Cursor among supported clients and gives the endpoint https://mcp.semrush.com/v2/mcp, streamable HTTP only, with OAuth by default or an Apikey header. |
| November 21, 2026 | Semrush's API units page says requests that return no data do not use units, and lists ERROR 132 or a 403 when units run out. |
| November 13, 2026 | Cursor's MCP documentation was checked: it names no plan, supports stdio, SSE and Streamable HTTP, and asks for approval before MCP tools run by default. The page gives no launch or change dates. |
| November 8, 2026 | The Ryze AI Semrush facts were checked against the help center and app source: one read tool, a Semrush API key, one key per workspace. |
Sources: Semrush MCP server docs, Semrush API units balance, Cursor MCP documentation. Checked November 21, 2026.
How this guide was tested
No call was run for this guide. Everything here comes from the Ryze AI help center and facts file, Cursor's documentation (read November 13, 2026) and Semrush's documentation (read November 21, 2026).
| What was run | What came back |
|---|---|
| Calls to Semrush | None. No Semrush key was connected, so no Semrush call was run. |
| The Semrush tool name | Taken from the Ryze AI app source. It was not seen in a live tool list. |
| The steps inside Cursor | None run. No server was added in Cursor. |
| Semrush's own server | Read from Semrush's docs. Not connected. |
Not run for this page: the Add to Cursor install, the mcp.json entry, the sign-in and any call to Semrush. With no Semrush key connected, this guide has no table of tested calls and no error messages copied from a test, so the errors below are documented answers.
Cursor and Semrush errors and fixes
No error message was copied from a test, because no Semrush call was run. These are the documented answers.
Documented errors and fixes
- ERROR 132 from Semrush
- Per Semrush, this is the reply when the API-unit balance is empty for the SEO, Trends and Projects APIs; some calls give a 403 instead. Only a top-up in your Semrush account fixes it.
- No Semrush tool in the Cursor tool list
- The Ryze AI help center says the tool list is set when the connector is added. When Semrush was connected later, remove the ryze server, add it again and open a new chat.
- Cursor reports that a subscription is required
- The Semrush tool runs only on an active Ryze AI plan or trial. With neither, the connector can list workspaces and connect platforms, and nothing more.
- Sign-in hangs or loops
- Remove the ryze server, add it again and finish the Ryze AI page with Allow connection. A Cursor Enterprise MCP allowlist can also block the server.
- Ryze AI refuses the key
- Either the Semrush plan has no API access or part of the key was missed when copying. Copy it whole from Subscription info, API units tab.
- An empty report
- The domain may have no data in that country database, so try another one. Semrush uses no units on a request that returns nothing.
- Wrong Semrush account behind the key
- The key picks the account. In Ryze AI click View on the Semrush card, use the trash icon, then connect with the right key.
- Cloud Agent has no Semrush access
- Cloud Agents hold their own MCP sign-ins. Connect the Ryze AI server for the agent as well.
- Connection link refused
- A link made by the Ryze AI agent works once within 24 hours, and Ryze AI refuses it while a Semrush key is already saved in the workspace. Swap keys in the Ryze AI app.
Terms on this page
- MCP
- Model Context Protocol, the open standard that lets an AI client call tools on a server such as the Ryze AI connector.
- mcp.json
- Cursor's config file for MCP servers, per project or for every project.
- API units
- The balance Semrush charges for API calls. It belongs to your Semrush account, and Ryze AI credits do not pay it.
- Regional database
- The country index a Semrush keyword or domain report reads from, such as US or UK.
- Authority Score
- Semrush's domain score returned with the backlinks overview.
- Position Tracking
- Semrush's rank-tracking campaigns. Ryze AI reads their reports and does not create or edit them.
- Cloud Agents
- Cursor agents that run on Cursor's servers and keep their own MCP sign-ins.
Source for MCP: modelcontextprotocol.io. Checked November 21, 2026.
Frequently asked questions
How do I connect Cursor to Semrush?
Save your Semrush API key on the Semrush card in Ryze AI. Then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or an mcp.json url entry, sign in to Ryze AI and open a new chat.
Does Semrush have its own MCP server for Cursor?
Yes. Semrush documents a server at https://mcp.semrush.com/v2/mcp with a Cursor config, signed in by OAuth or an Apikey header. The Ryze AI connector at https://connector.get-ryze.ai/mcp is a separate route with one read-only Semrush tool.
What URL goes in mcp.json for Semrush?
Semrush's own server uses https://mcp.semrush.com/v2/mcp. The Ryze AI connector uses https://connector.get-ryze.ai/mcp, identical for every user.
Will Cursor edit anything in my Semrush account?
Not through Ryze AI, whose only Semrush tool reads and cannot create or edit Position Tracking campaigns. Semrush says its own MCP server cannot create projects or change settings either.
Is a particular Cursor plan required?
Cursor's MCP documentation names none. Enterprise admins can set which MCP servers users may run in Team Settings, MCP Configuration.
Where is the Semrush API key?
In Semrush open Subscription info, then the API units tab. The key works only on a Semrush plan with API access.
Is a paid Semrush plan needed for Semrush's own server?
Yes. Semrush lists an active plan such as Semrush One Starter or Pro+, or SEO Classic Pro or Guru, with at least 50,000 MCP API units per monthly cycle depending on plan. The Ryze AI route uses your API key and an active Ryze AI plan or trial.
How many Semrush API units will a Cursor question cost?
That depends on the report. Per-line reports are charged by rows returned, fixed-cost reports per request, and a request with no data uses no units. A row limit in your prompt keeps the bill small.
Does Cursor ask before calling Semrush?
By default it does: Cursor asks for approval before using an MCP tool and follows the same Run Modes as terminal commands. In Auto-review mode, allowlisted MCP tools run immediately.
Can a Ryze AI API key replace the browser sign-in?
Yes. Add a headers entry with Authorization: Bearer and the rk_live_ key from Ryze AI Workspace Settings, Profile, API keys, read from an environment variable. It is a Ryze AI key, never your Semrush key.
Can one workspace hold two Semrush accounts?
No. A workspace holds one key, and Ryze AI does not list Semrush among platforms with several accounts. Disconnect and reconnect to switch keys, or put the second account in another workspace.
Why is the Semrush tool missing in Cursor?
You probably connected Semrush in Ryze AI after adding the server. Remove and re-add the ryze server in Cursor, then start a new chat so the tool list refreshes.
What does connecting Cursor to Semrush cost?
Adding the connector is free, but the Semrush tool needs an active Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial, Paid Ads is $89 per month with a 7-day free trial and Agency is $279 per month. Annual billing takes 30% off the first year. Semrush bills the API units.
Can Cursor read backlinks and referring domains?
Yes. The Ryze AI tool reads a backlinks overview with Authority Score, plus referring domains, anchors and individual backlinks.