By Ira Bodnar, Ryze AI · Updated · Sources checked the same day
Quick answer
The main way to connect Cursor to Ahrefs is the Ryze AI connector. Add your Ahrefs API key under Integrations 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 when Cursor asks. Ahrefs also runs its own MCP server at https://api.ahrefs.com/mcp/mcp. It reaches more of Ahrefs, publishes no Cursor guide, and is compared below.
- Create an API key in Ahrefs under Account settings > API keys
- Open Integrations in Ryze AI, press Connect on the Ahrefs card, paste the key
- Install the Ryze AI server in Cursor, by link or by editing mcp.json, and sign in
- Open a fresh Cursor chat and ask a link or keyword question about a domain
Cursor to Ahrefs at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP address that Cursor loads from an install link or an mcp.json url entry |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | Browser OAuth with Ryze AI, or a Ryze AI API key in a headers entry. The Ahrefs key never goes into Cursor, it stays saved in Ryze AI |
| Ahrefs tools | 1 tool, ahrefs__read, which wraps GET calls to Ahrefs API v3 |
| Can it change things in Ahrefs | No, the single tool is GET only |
| Other data in the same chat | Any other platform connected in the same Ryze AI workspace shows up behind the same address |
| Cursor plan needed | None is named in Cursor's MCP documentation. Enterprise admins can restrict which MCP servers run |
| Ahrefs plan needed | One that includes API access, since each call spends units from your own Ahrefs balance |
| Ryze AI price | SEO Starter costs $129 a month with a 3-day trial, Paid Ads costs $89 a month with a 7-day trial, and adding the connector is free |
| Ahrefs's own option for Cursor | Ahrefs hosts https://api.ahrefs.com/mcp/mcp for Lite plans and above, and has no Cursor setup page |
| Last checked | Sources opened November 20, 2026, Cursor facts recorded November 13, 2026, and no connector call was run |
Before you start
- Cursor. The MCP documentation names no plan. On Enterprise, admins decide which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
- Ahrefs API access and a role that can create keys. Ahrefs limits the API keys section to workspace owners and admins, and a plan without API access is rejected.
- A Ryze AI workspace with a plan or trial. Pick SEO Starter ($129 a month, 3-day trial) or Paid Ads ($89 a month, 7-day trial). The connector itself is free to add, yet the Ahrefs tool only runs under an active plan or trial.
How to connect Cursor to Ahrefs
Two steps happen in Ahrefs and Ryze AI, two in Cursor, and the last is your first prompt. The connector URL is the same for every user.
Generate an Ahrefs API key
Sign in to Ahrefs, go to Account settings, then API keys, and press Generate API key. Give it a label such as Ryze AI and copy the value. Owners and admins only.
Save the key in Ryze AI
Sign in to Ryze AI, open Integrations, press Connect on the Ahrefs card, paste the key into the API key field and press Continue. You can also ask the Ryze AI agent in Claude or ChatGPT for a one-time link that opens a page for the key; it works once within 24 hours.
Add the Ryze AI server to Cursor
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 write the url entry shown below into ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project).
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Sign in from Cursor
Confirm the install in Cursor. OAuth with PKCE and dynamic client registration runs on its own, so no client ID or secret is needed. Sign in on the Ryze AI page and press Allow connection. The Customize page in the sidebar lets you toggle the server.
Ask your first question in Cursor
Open a new chat, approve the tool call when Cursor prompts, and try: How strong is the backlink profile of the domain I name, and how many sites link to it?
The Ryze AI help center page for Ahrefs covers the Ahrefs 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 Ahrefs 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. If you connected Ahrefs in Ryze AI after adding the server, remove the server in Cursor, add it again and start a new chat so the tool list refreshes.
{
"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. This is the Ryze AI key, separate from your Ahrefs API key. Keep both 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 needs Ahrefs 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 |
| Limit on tools or servers | Not stated on Cursor's MCP page |
Sources: Cursor MCP documentation, Cursor MCP install links. Checked November 20, 2026.
Claude and ChatGPT
The same URL works in other MCP clients. Ahrefs is connected once in Ryze AI, so nothing changes on the Ahrefs side.
Claude
Under Customize > Connectors add https://connector.get-ryze.ai/mcp as a custom connector, choose workspaces and open a new chat. The Ahrefs key stays in Ryze AI, so Ahrefs needs no change.
ChatGPT
Under Settings > Apps add the same URL, choose workspaces and start a new chat. When Ahrefs was connected after the app, remove the app and add it again to refresh its tools.
Ahrefs access and API key
Cursor talks to Ryze AI, and Ryze AI talks to Ahrefs with the API key you saved. Three things set the reach.
- Which Ahrefs account
- The account behind the key saved in Ryze AI. Each workspace holds one Ahrefs connection. To swap keys, press View on the Ahrefs card, disconnect with the trash icon and connect again. A second workspace may hold another key.
- What the key allows
- Ahrefs creates keys under Account settings > API keys and shows that section to owners and admins only. Ryze AI facts add a one-year validity per key.
- What Cursor asks first
- By default Cursor asks before using an MCP tool. Since the Ahrefs tool is read only, no choice of approval mode can alter anything in Ahrefs. Enterprise admins can allowlist servers and tools for the team.
What decides the access
Ryze AI documents no OAuth scopes for Ahrefs. Reach depends on the key and on the Ahrefs plan behind it, as the table lays out.
| Part | What it decides | Detail |
|---|---|---|
| API key | The Ahrefs workspace being read | Made by an owner or admin under Account settings > API keys |
| Ahrefs plan | Whether Ahrefs answers the call | Without API access on the plan, the call is refused |
| API units | Monthly call budget | Spent from your own Ahrefs balance, never from Ryze AI credits |
| Per-key limit | Cap on one key | Managed in Ahrefs under Account settings > Limits & usage |
| Ryze AI plan or trial | Whether the Ahrefs tool is available | With neither, the connector only lists workspaces and connects platforms |
Not included: any change to Ahrefs. The tool is GET only. Ahrefs's own MCP server lists a management group for projects, keyword lists, locations and Brand Radar configuration, which the Ryze AI connector does not expose.
Sources: Ahrefs MCP introduction, Ryze AI Ahrefs guide. Checked November 20, 2026.
Removing access
To remove access, disconnect Ahrefs from its card in Ryze AI and delete the key in Ahrefs under Account settings > API keys. In Cursor, toggle the ryze server off or remove its entry from mcp.json.
What Cursor can do in Ahrefs
Ryze AI offers a single Ahrefs tool and it reads only. Every prompt on this page runs through it.
| Tool | Type | What it does |
|---|---|---|
| ahrefs__read | Read | Sends a read-only GET request to Ahrefs API v3. Examples named in the facts: Domain Rating, site metrics, referring domains, backlinks, broken backlinks, anchors, organic keywords, Keywords Explorer overview, and API limits and usage. |
Each call draws on your own Ahrefs units. Request fewer rows and fewer fields to spend less, and ask Cursor to check your API limits and usage to see the balance. The same figure sits in Ahrefs under Account settings > Limits & usage.
Cursor asks before it runs an MCP tool by default. Keep that default if you want to see each call before it spends Ahrefs API units. Separately, the Ryze AI chat has its own Tool approvals picker, which starts on Skip all approvals.
Limits in numbers
| Limit | Number |
|---|---|
| Price of a request | The larger of the 50-unit base cost and (per-row cost x rows). |
| Per-row cost | Add up the cost of every distinct field in the response, filter or sort. A field is 1 unit unless Ahrefs lists more. |
| Ahrefs worked examples | A Domain Rating request lands under the base cost and costs 50 units. Ahrefs's second example, a Site Explorer backlinks request, costs 6,000 units. |
| Monthly allowance | Decided by your Ahrefs plan, visible in Account settings > Limits & usage. |
| Keys created through OAuth for MCP | Start with a cap of 200,000 units a month each. Workspace admins may change or lift it, and hand-made keys have no per-key cap. |
| Rows per request | Ahrefs gives each plan a maximum row count for AI agents. See Ahrefs's pricing page for the figure. |
| Cursor side | Cursor's MCP page states no cap on tools or servers. |
Sources: Ahrefs limits and consumption, Ahrefs MCP introduction, Cursor MCP documentation. Checked November 20, 2026.
First 3 prompts to run
1. Size up a competitor's link profile
For the domain I name, give me the Domain Rating plus the totals for backlinks and referring domains.
Tools used: ahrefs__read
What comes back: The authority score and link totals Ahrefs holds for that target. Nothing is edited.
2. Find links that point to dead pages
Show broken backlinks to my site: which page links, and which of my URLs no longer loads. Limit it to five rows.
Tools used: ahrefs__read
What comes back: Broken backlinks in the shape Ahrefs returns them. Keep the row count low, since rows cost units.
3. Check which keywords a site ranks for
Which organic keywords does my domain rank for? Then give the Keywords Explorer overview for five of them in the United States.
Tools used: ahrefs__read
What comes back: Organic keywords from Ahrefs, followed by overview metrics for the five you picked in that country.
No Ahrefs call was made while writing this page, so it prints no sample output. Swap in your own domain and expect figures from your own Ahrefs account.
10 jobs to hand to Cursor
Ten requests you can give Cursor. Each one maps to the lone Ahrefs tool and none edits anything in Ahrefs. None was run for this page.
| Job | Ask Cursor | Tool | Changes Ahrefs |
|---|---|---|---|
| Authority score | Tell me the Domain Rating for this domain. | ahrefs__read | No |
| Link totals | Give backlink and referring-domain totals for this domain. | ahrefs__read | No |
| Linking sites | Name five referring domains for this site. | ahrefs__read | No |
| Linking pages | Name five backlinks to this URL. | ahrefs__read | No |
| Dead-link targets | Which broken backlinks does my domain have? | ahrefs__read | No |
| Anchor mix | What anchor texts do links to my domain use? | ahrefs__read | No |
| Ranking terms | Which organic keywords does this site rank for? | ahrefs__read | No |
| Keyword research | Run the Keywords Explorer overview for these terms in this country. | ahrefs__read | No |
| Scope comparison | Compare site metrics for this subdomain, this path and this exact URL. | ahrefs__read | No |
| Unit balance | How many Ahrefs API units have I used, and what are my limits? | ahrefs__read | No |
4 ways to connect Cursor to Ahrefs
Four routes lead from Cursor to Ahrefs data. This guide treats the Ryze AI connector as the main one: you save one API key in Ryze AI and add one address to Cursor, and that address also serves other platforms in your workspace. Ahrefs's own hosted MCP server is the second route and covers far more of Ahrefs. Its setup pages cover Claude, Copilot Studio, ChatGPT, Lovable, n8n, Manus, Le Chat and OpenClaw but not Cursor, so the Cursor steps for it rely on Cursor's general remote server support and were not tested.
| Way | Runs where | Setup in Cursor | What it reaches in Ahrefs | Price and units |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, same address for all users | Install link or url entry in mcp.json for https://connector.get-ryze.ai/mcp, then Ryze AI sign-in | 1 read tool over Ahrefs API v3 with Domain Rating, site metrics, backlinks, broken backlinks, referring domains, anchors, organic keywords, Keywords Explorer overview and limits | $129 a month for SEO Starter (3-day trial) or $89 a month for Paid Ads (7-day trial), plus your Ahrefs units |
| Ahrefs MCP server (Ahrefs's own) | Hosted by Ahrefs at https://api.ahrefs.com/mcp/mcp over Streamable HTTP | No Cursor page from Ahrefs. Add the URL as a remote server in mcp.json and accept the Ahrefs consent screen. Untested | Tool groups spanning Site Explorer, Keywords Explorer, SERP Overview, Rank Tracker, Site Audit, Brand Radar, Web Analytics, Search Console data, social media, Content Helper, batch analysis, account management and subscription info | Ahrefs Lite or higher. Spends plan units, and OAuth keys begin at 200,000 units a month |
| Ahrefs MCP server with a hand-made MCP key | Hosted by Ahrefs | Ahrefs says an MCP key can be generated in your account and placed in an agent's configuration. No Cursor entry is documented. Enterprise accounts may also use API keys | Same tool groups as the row above | Same plan and unit rules |
| Ahrefs REST API from your own code | Scripts you run | Not MCP. Ahrefs declares custom scripts, bridges and standalone HTTP or JSON-RPC clients against its MCP endpoint unsupported and not permitted | All of API v3, authenticated by an Authorization header key | Needs API access; spends units |
Two options that do not fit this job
- Scripts pointed at Ahrefs's MCP address. Ahrefs calls this unsupported and not permitted, and sends code users to the REST API.
- The Claude and ChatGPT pages from Ahrefs. They describe menus in those apps, which Cursor lacks, so follow the Cursor steps above.
Which one to pick
Ryze AI is the best way to connect Cursor to Ahrefs if you already use the Ryze AI connector for other platforms and want Ahrefs on that same address, with one caveat: it has a single read tool, while Ahrefs's server has many groups, among them Site Audit, Rank Tracker and Brand Radar. Choose Ahrefs's server when Ahrefs is your only data source or you need those groups. Ahrefs notes that some MCP clients cap the tools a server may advertise and offers a tools query parameter to pick groups; Cursor's MCP page states no such cap. You can add both servers to Cursor together, and both spend your Ahrefs units.
Sources: Ahrefs MCP introduction, Ahrefs MCP tool categories, Ahrefs limits and consumption, Cursor MCP documentation, Ryze AI Ahrefs guide. Checked November 20, 2026.
Ahrefs, Cursor and MCP: dates that matter
| Date | What happened |
|---|---|
| November 13, 2026 | Date of the Cursor MCP facts used here: remote servers by url in mcp.json, OAuth with dynamic client registration, approval before MCP tool use by default, and the cursor:// install link format. Cursor's pages state no launch or change dates. |
| November 20, 2026 | Ahrefs's MCP documentation describes a hosted Streamable HTTP server at https://api.ahrefs.com/mcp/mcp for paid plans from Lite, with setup guides for Claude Desktop and Web, Claude Mobile, Claude Code, Copilot Studio, ChatGPT Web, Lovable, n8n, Manus, Le Chat and OpenClaw, and none for Cursor. |
| November 20, 2026 | Ahrefs's documentation lists 20 tool groups for the server, selected with a tools query parameter, and says keys created through OAuth for MCP default to 200,000 API units a month. |
Sources: Ahrefs MCP introduction, Ahrefs MCP tool categories, Cursor MCP documentation. Checked November 20, 2026.
How this guide was tested
This guide comes from documentation. Nothing was called through the Ryze AI connector to write it, so it holds no tested output and no sample figures.
| What was run | What came back |
|---|---|
| Ahrefs MCP and API documentation | Opened November 20, 2026: the MCP introduction, the tool categories page and the API limits consumption page. |
| Ryze AI facts for Ahrefs | The Ryze AI entry for Ahrefs (checked November 8, 2026) supplies the tool, key steps and limits used here. The tool name comes from Ryze AI's app source, not from a live tool list. |
| Cursor facts | Recorded November 13, 2026 from Cursor's MCP documentation and install link page, plus the Ryze AI entry for Cursor. |
Not run: the steps inside Cursor, any sign-in, any ahrefs__read call. Prompts and jobs say what you can ask and show no results. Read the setup as the documented route, not a recorded session.
Cursor and Ahrefs errors and fixes
This page lists no exact error text from a test run, because no call was run. The entries above come from the Ryze AI and Cursor facts.
Problems and fixes
- The Ahrefs tool is missing in Cursor
- You may have connected Ahrefs after adding the server. Remove the ryze server in Cursor, add it again and begin a new chat to refresh the tool list.
- No sign-in prompt appears
- Check on the Customize page that the ryze server is on. Cursor runs OAuth by itself, so the mcp.json entry needs only the url.
- Ahrefs refuses the key
- Plans without API access are refused. Confirm the plan and that the key still shows as active in Account settings > API keys.
- Calls fail late in the month
- Your Ahrefs units or a per-key cap may be spent. Ask Cursor for your API limits and usage, or look in Account settings > Limits & usage.
- The one-time link is rejected
- It is rejected when the workspace already has Ahrefs connected. Change keys in the Ryze AI app with View, disconnect, connect.
- The tool says a subscription is needed
- The Ahrefs tool requires an active Ryze AI plan or trial. Start the trial and retry.
- A team blocks the server
- On Enterprise, admins govern MCP servers in Team Settings > MCP Configuration. Ask one to allow ryze.
- A Cloud Agent cannot see Ahrefs
- Cloud Agents hold their own MCP sign-ins on Cursor's servers. Connect the Ryze AI server for the agent too.
Terms on this page
- MCP
- Model Context Protocol, an open standard that lets AI apps reach outside systems. Cursor, Claude and Ahrefs support it.
- MCP server
- A service that offers tools over MCP. Ryze AI runs its connector itself, so you install nothing.
- mcp.json
- Cursor's MCP config file: ~/.cursor/mcp.json for all projects, .cursor/mcp.json for one.
- API unit
- Ahrefs's billing measure for API calls, at least 50 per request, drawn from a monthly plan allowance.
- Domain Rating
- Ahrefs's score of how strong a site's backlink profile is.
- Referring domain
- One distinct site linking to yours, however many links it has.
- Backlink
- A link from another page to yours. A broken one targets a page that no longer loads.
Source for MCP: modelcontextprotocol.io. Checked November 20, 2026.
Frequently asked questions
How do I connect Cursor to Ahrefs?
Create an Ahrefs API key, save it on the Ahrefs card in Ryze AI, then add https://connector.get-ryze.ai/mcp to Cursor through the Add to Cursor link or an mcp.json url entry and sign in. Open a new chat when done.
Is there an Ahrefs MCP server for Cursor?
Ahrefs runs its own server at https://api.ahrefs.com/mcp/mcp for Lite plans and above, yet none of its setup pages covers Cursor. The Ryze AI connector at https://connector.get-ryze.ai/mcp offers 1 Ahrefs tool over API v3 data and is set up in Cursor with the steps above.
What URL does Ahrefs's own MCP server use?
https://api.ahrefs.com/mcp/mcp, a Streamable HTTP endpoint. Ryze AI's connector is https://connector.get-ryze.ai/mcp for every user.
Should I pick Ryze AI or Ahrefs's server in Cursor?
Pick Ahrefs's server if Ahrefs is the only source you need or you want Site Audit, Rank Tracker or Brand Radar, accepting that Ahrefs publishes no Cursor guide. Pick the Ryze AI connector if Ahrefs should share an address with your other Ryze AI platforms. Both use your Ahrefs units and can run together.
Can Cursor edit my Ahrefs account?
Not via the Ryze AI connector. Its lone Ahrefs tool sends GET requests, so projects, keyword lists and settings stay as they are.
What Ahrefs data can Cursor read through Ryze AI?
Domain Rating and site metrics for a domain, subdomain, path or URL, plus backlinks, broken backlinks, referring domains, anchors, organic keywords, Keywords Explorer overview for a country, and your API limits and usage.
Which Cursor plan is required?
Cursor's MCP documentation names none. Enterprise admins can limit which MCP servers users run in Team Settings > MCP Configuration.
Is an Ahrefs API subscription necessary?
Yes for the Ryze AI route, because it spends your own key and units and a plan lacking API access is refused. Ahrefs says its own server needs Lite or higher.
What does one Ahrefs call cost in units?
No less than 50. Ahrefs bills the greater of a 50-unit base and per-row cost times rows, with fields at 1 unit unless listed higher.
Who may create an Ahrefs API key?
Workspace owners and admins, who are the only people shown Account settings > API keys. Ryze AI facts add that a key lasts one year.
Can one workspace hold two Ahrefs accounts?
No. A Ryze AI workspace holds one Ahrefs connection. Swap keys by disconnecting on the Ahrefs card and connecting again, or use another workspace for a different key.
Why is the Ahrefs tool absent in Cursor?
Likely Ahrefs was connected after the server was added. Remove the server in Cursor, add it again and open a new chat so the tool list reloads.
What does it cost to use Ahrefs in Cursor via Ryze AI?
Adding the connector is free, but the Ahrefs tool requires a Ryze AI plan or trial: SEO Starter at $129 a month with 3 trial days, or Paid Ads at $89 a month with 7 trial days. Annual billing takes 30% off the first year. Ahrefs charges its own API units on top.
Will Cursor ask before running an Ahrefs call?
By default yes. Cursor asks before using MCP tools and follows its Run Modes. In Auto-review mode, allowlisted MCP tools run immediately.
How do I remove Ahrefs from Cursor?
Switch the ryze server off on the Customize page or delete it from mcp.json. To end Ahrefs access, disconnect the Ahrefs card in Ryze AI and delete the key in Ahrefs.