Where it fits
SEO specialists and marketers who need current keyword, ranking, and competitor data while working inside an AI agent.
- Audit keyword rankings for a target page
- Compare backlink profiles across competitor sites
- Find keyword gaps before writing a landing page
A remote MCP server advertises tools to your client. The provider controls the tools, the data they can reach, and the permissions they need. Read the provider's docs before you use it with private data.
Skills that pair with Ahrefs
These skills cover adjacent tasks, matched by purpose and the work each one describes.
Search engine optimization and Generative Engine Optimization for sites: keyword analysis, schema markup, and tuning for AI search engines (ChatGPT, Perplexity, Gemini, Copilot, Claude) as well as Google and Bing. Applies to visibility and ranking work, Google AI Overview placement, indexing, JSON-LD, meta tags, and keyword research.
Run an SEO audit covering keyword research, on-page analysis, content gaps, technical checks, and competitor comparison. Use it to assess a site's SEO health, find keyword opportunities and content gaps that competitors own, or build a prioritized action plan split into quick wins and strategic investments.
Audits a website for on-page and technical SEO problems by reading titles, meta descriptions, headings, canonicals, structured data, and internal links. Useful for SEO audits, page-source checks, broken-link reviews, or comparing pages against target keywords, even when nobody asked for scraping. Findings are tied to the page source and ordered by priority. Generic SEO explanations, copywriting on its own, and functional testing of the site are excluded.
No skills found
Try a different search term or clear the filters.
Install it in your client
Choose a client, run the command or use the one-click install, then verify the connection. The endpoint uses Streamable HTTP.
- 01
Run this command in your terminal
This adds Ahrefs as a remote Streamable HTTP server in Claude Code.
Claude Codeclaude mcp add --transport http ahrefs https://api.ahrefs.com/mcp/mcp --scope project - 02
Verify the connection
Run claude mcp list, or open /mcp in a Claude Code session.
Learn more about MCP in Claude Code
- 01
Run this command in your terminal
This adds Ahrefs as a remote Streamable HTTP server in Codex.
Codex# Add this to Codex MCP settings: [mcp_servers."ahrefs"] url = "https://api.ahrefs.com/mcp/mcp" - 02
Verify the connection
Run codex mcp list, or open /mcp in a Codex session.
Learn more about MCP in Codex
- 01
Install with one click
This opens Cursor with the server pre-filled. Review the connection before accepting it.
Install in Cursor - 02
Verify the connection
Open Cursor's MCP settings and enable the server if it is not active.
Learn more about MCP in Cursor
- 01
Install with one click
This opens VS Code with the server pre-filled. Review the connection before accepting it.
Install in VS Code - 02
Verify the connection
Run MCP: List Servers from the Command Palette and start the server.
Learn more about MCP in VS Code
More clients, including project and global config files, are in the sidebar.
Endpoint and configuration
The installer uses the server name ahrefs. If you add the endpoint by hand, keep the same name so the guide and your config match.
Check the connection
After you add the server, confirm that the client can see its tools and that one small request returns what the provider describes.
- 1Open the tool list.
Restart the client or start a new session. Confirm that
ahrefsappears and that the tools match the provider documentation. - 2Run one small request.
Start with: Audit keyword rankings for a target page. Check the result before you give the server more access.
- 3Check permissions.
Review the OAuth scopes or API-key permissions, then remove the server and revoke its token when you no longer need it.
We checked the provider's page, not the MCP connection itself. No MCP sign-in or tool call was attempted. The provider page was available when we checked.
Common failure modes
These are the problems to check first. If the provider changes its endpoint or authentication flow, use its documentation as the source of truth.
- The sign-in window closes without returning. Allow pop-ups and finish the provider login in the same browser.
- The server connects but its tools are missing. Remove it, add it again, and approve the scopes the provider lists.
- Your client does not support Streamable HTTP. Use a client that does, and confirm the provider's current endpoint and transport in its docs.
Before you connect
- The provider can see the requests and data your agent sends through the server.
- Review OAuth scopes and API-key permissions. Start read-only if the provider offers it.
- Use project scope for repository-specific servers; use global scope for personal tools.
- Remove the server and revoke its token when you stop using it.
Check the connection before a real task
These guides cover the decisions that a provider description cannot answer: endpoint ownership, scopes, tool access, and a read-only test.
Provider documentation
Setup requirements, available tools, and rate limits live with the provider. Use the source link as the authority for this server.
Ahrefs documentationhttps://docs.ahrefs.com/docs/api/reference/limits-consumption