How to connect Cursor to Semrush

Save your Semrush API key in Ryze AI, add one MCP URL to Cursor, then ask Cursor about domains, ranking keywords, organic competitors and backlinks.

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 · 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.

  1. In Semrush open Subscription info, API units tab, and copy the API key
  2. In Ryze AI open Integrations, click Connect on Semrush, paste the key and click Continue
  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 a domain, its keywords or its backlinks

Cursor to Semrush at a glance

FactDetail
Main way to connectThe Ryze AI connector: one hosted address, added to Cursor by an install link or a url entry in mcp.json
Connector addresshttps://connector.get-ryze.ai/mcp
What Semrush needsYour 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 inOAuth to Ryze AI with PKCE and dynamic client registration. A Ryze AI API key in a header is the alternative
Semrush tools1: semrush__read, a read-only Semrush Analytics API tool that also lists projects and reads Position Tracking reports
Can Cursor change SemrushNo. The only Semrush tool reads, so it cannot create or edit Position Tracking campaigns
What it costs in SemrushEvery call draws on your own Semrush API-unit balance. Ryze AI credits do not pay for it
Cursor planCursor'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 CursorSemrush'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 testedNo 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.

  1. 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.

  2. 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.

  3. 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" } } }
  4. 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.

  5. 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

TopicWhat Cursor's documentation says
Config files.cursor/mcp.json inside a project, or ~/.cursor/mcp.json for every project
Remote serversAn entry under mcpServers with a url, plus an optional headers object
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; Enterprise admins can set an MCP allowlist
Install linkcursor://anysphere.cursor-deeplink/mcp/install, with the server name and a base64 copy of the config
PlanThe 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.

ItemWhat it coversSource
API keyAuthorizes each request and bills it to your account's API-unit balance. Found under Subscription info, API units tabRyze AI help center
Plan with API accessRequired before the key works. Without it Ryze AI cannot read dataRyze AI help center
API-unit balanceEvery call draws on it. At zero, Semrush returns ERROR 132 or 403 depending on the API, and only you can top it upSemrush API units docs
Regional databaseDomain and keyword reports are asked for one regional database, such as US or UKRyze 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.

ToolTypeWhat it does
semrush__readReadRuns 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

LimitNumber
Semrush API-unit balanceEvery 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 reportsCharged by the data returned, such as domain reports. A display limit keeps the cost down
Fixed-cost reportsCharged per request whatever comes back, such as the backlinks overview
Empty resultsA request that returns no data uses no units
Balance checkFree, in Subscription info, API units tab, or by a free Standard API call
Semrush's own MCP serverA minimum of 50,000 MCP API units per monthly billing cycle, depending on plan, per Semrush's MCP page
Ryze AI connectionOne Semrush key per workspace, and one connection can cover up to 20 workspaces
Tools or servers in CursorNot 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.

JobAsk CursorToolWorks on the default connection
Size up a sitePull the Semrush overview for example.com in the US database.semrush__readYes
Top rankingsShow the organic keywords where this domain holds a position, with traffic.semrush__readYes
Find rivalsName the sites that compete with this domain for the same organic searches.semrush__readYes
Check phrasesReturn volume, CPC and competition for these five phrases in the UK database.semrush__readYes
Link strengthRead Authority Score and the backlink totals for this domain.semrush__readYes
Who links inList the referring domains pointing at this site.semrush__readYes
Anchor mixShow the anchor texts that other sites use when linking here.semrush__readYes
Link by linkPull a sample of individual backlinks for this domain.semrush__readYes
Rank tracking reportsList my Semrush projects and read the Position Tracking report of one campaign.semrush__readYes, reports only
Start a new campaignCreate a Position Tracking campaign for this domain.noneNo. 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.

WayRuns whereSetup in CursorWhat Cursor reaches in SemrushPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one address for every userAdd to Cursor link or a url entry in mcp.json for https://connector.get-ryze.ai/mcp, then an OAuth sign-in to Ryze AIYour key's account, through one read tool for domain, keyword and backlink reports, projects and Position Tracking reportsSEO Starter is $129 per month with a 3-day free trial; Semrush API units are billed by Semrush
Semrush's own MCP serverSemrush's hosted server at https://mcp.semrush.com/v2/mcp, streamable HTTP onlySemrush'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 headerRead-only Trends API, SEO API and Projects API methods, per Semrush. Semrush says it cannot create projects or change settingsNeeds 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 scriptYour code calls the Semrush Analytics APINothing in Cursor itself. You write or ask Cursor to write the requestsWhatever the API allows for your keySame 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

DateWhat happened
November 21, 2026Semrush'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, 2026Semrush'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, 2026Cursor'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, 2026The 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 runWhat came back
Calls to SemrushNone. No Semrush key was connected, so no Semrush call was run.
The Semrush tool nameTaken from the Ryze AI app source. It was not seen in a live tool list.
The steps inside CursorNone run. No server was added in Cursor.
Semrush's own serverRead 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.

Connect Semrush to Cursor

Your Semrush key is saved once in Ryze AI, then Cursor reads domain, keyword and backlink data. SEO Starter is $129 per month with a 3-day free trial, and Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Semrush MCP server

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