What Ahrefs exposes
Ahrefs exposes its data through five developer surfaces that all share the same monthly API Units budget. The REST API covers 11 endpoint categories: Site Explorer (backlinks, organic and paid traffic), Keywords Explorer, Site Audit, SERP Overview, Rank Tracker, Batch Analysis (up to 100 targets per request), Brand Radar, Social Media Management, plus account management and subscription endpoints. The MCP server exposes the same surface to AI clients via natural language. Data Studio (Looker) connectors ship for Site Explorer, Rank Tracker, Site Audit, and Brand Radar, no code required for dashboards. Bot Analytics tracks bot crawls (including GPTBot and ClaudeBot) via Cloudflare Logpush or a Worker integration. Ahrefs Connect is the white-label data layer for third-party apps embedding Ahrefs, included on every paid plan.
Access, auth, and limits
The Ahrefs MCP server is available on every paid plan from Lite up; Starter and the free Ahrefs Free tier are excluded. It shares the monthly API Units budget with the REST API and Ahrefs Connect: 100,000 units on Lite, 400,000 on Standard, 1M on Advanced, 2M on Enterprise. Using MCP heavily on Lite means fewer units left for direct API calls. Row limits per single MCP call scale by tier: 100 / 250 / 500 / Unlimited.
Authentication is API-key based. When you connect a new MCP client, Ahrefs provisions a dedicated key in your account tagged with MCP scope after the connection is approved. The server endpoint is https://api.ahrefs.com/mcp/mcp with Streamable HTTP transport. A legacy SSE endpoint at /mcp/mcpSse remains for older clients but is deprecated and not recommended for new setups.
Where it works and what to build
Ahrefs ships setup guides for 11 MCP clients: Claude Desktop, Claude Web, Claude Mobile, Claude Code, Cursor, ChatGPT Web, Copilot Studio, n8n, Lovable, Manus, Mistral Le Chat, and OpenClaw. That's the widest first-party MCP client coverage I've seen from an SEO vendor. Real workflows worth running: ask Claude to pull a competitor's top-10 organic pages and their referring domain counts (Site Explorer + Batch Analysis), have it score keyword opportunities for a content brief using KD + traffic potential (Keywords Explorer + SERP Overview), or audit a client site and queue the broken-link fixes (Site Audit). When to reach for Agent A instead: Agent A uses the same Ahrefs endpoints but the same UI layer the dashboard does, which means broader metric access than the public MCP exposes. MCP is the right tool for one-off agent queries; Agent A is the right tool when you're shipping marketing work end-to-end inside an AI workspace.
Which AI clients can use Ahrefs MCP?
Not every AI assistant supports MCP natively. Per-client picture for Ahrefs:
| Client | Support | Notes |
|---|---|---|
| Claude (Desktop/Web) | Native MCP | Connect via the api.ahrefs.com/mcp/mcp URL in Claude Desktop. |
| Claude Code | Native MCP | — |
| ChatGPT | Native MCP | Ahrefs publishes a ChatGPT Web setup guide as one of 11 supported clients. |
| Cursor | Native MCP | — |
| Codex | Native MCP | — |
| Windsurf | Native MCP | — |
| Cline | Native MCP | — |
| Gemini | API-only (custom code) | — |
| n8n | Native MCP | Ahrefs ships an n8n setup guide; MCP HTTP Streamable node consumes API Units from the shared budget. |
How to connect Ahrefs MCP to Claude Desktop
Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Cursor and Codex use a similar schema.
{
"mcpServers": {
"ahrefs": {
"command": "npx",
"args": ["mcp-remote", "<YOUR_MCP_URL>"]
}
}
}
// HTTP-transport MCP. Get your <YOUR_MCP_URL> from the vendor dashboard.
// Server source: https://ahrefs.com/mcp/
// Claude Code (one-liner): claude mcp add ahrefs <YOUR_MCP_URL> --transport httpSome MCP servers require an API key. Check the source page for setup: ahrefs.com/mcp.
Does Ahrefs MCP cost extra?
Ahrefs ships an official MCP server that uses your existing subscription credentials.
- No separate MCP licence to buy. You pay for your Ahrefs plan, the MCP server queries that account.
- Whether it's gated to a specific tier wasn't extracted automatically — verify the access requirements on the MCP page or pricing docs.
Ahrefs subscription pricing
| Plan | Monthly | Annual / mo |
|---|---|---|
| Lite | $129 | $108 |
| Standard | $249 | $208 |
| Advanced | $449 | $374 |
| Enterprise | $1,499 | — |
| Starter | $29 | — |
| Ahrefs Free | — | — |
Source: ahrefs.com/pricing. Verified 2026-06-07.
Ahrefs also publishes a REST API
Ahrefs API is a separate product with its own tier ladder, billed on top of your Ahrefs subscription.
See Ahrefs API pageWhat you can do with Ahrefs from an AI agent
Three shapes of agent workflow. Pick the row that matches how you actually use Claude / Cursor / Codex day to day.
Skip the dashboard, ask Claude
- "What keywords moved this week?" answered in seconds
- Quick one-off questions without leaving the editor
- Pipe Ahrefs data into your personal notes / docs without writing a script
Run client analysis at agent speed
- Hand the MCP server to your team — every consultant can ask Claude about any client's Ahrefs account
- Multi-account workflows without context-switching the Ahrefs UI
- Reports you'd normally spend hours on, done before standup
Production agent workflows
- Embed in your internal Codex / Cursor agents that triage Ahrefs data daily
- Combine with other MCP servers in a multi-step agent chain
- Constrain agents to read-only roles to keep production Ahrefs safe
Limits and gotchas
- Official MCP server — published by Ahrefs themselves, so it should track product changes.
- Fallback: the REST API works for any flow the MCP server doesn't cover.
- Auth flow: MCP servers usually inherit the underlying API auth method (both). Expect to configure that on first install.
- Rate limits: MCP calls count against your underlying Ahrefs API quota. Burst usage from a curious agent can drain a daily allowance fast.
Agent-readiness verdict
Strong out of the box. Official MCP plus 11 endpoint categories plus 11 first-party client setup guides puts Ahrefs ahead of most SEO suites on agent-readiness. The shared-units budget is the main friction, heavy AI usage costs you headroom on every other surface.
Solid agent integration with official MCP support and well-documented API across Claude, ChatGPT, and Gemini. The official MCP server and public API docs make it straightforward to embed Ahrefs queries into agent workflows. Main limitation is the lack of webhooks and structured outputs, which restricts real-time automation and reduces output consistency for downstream processing.
Scored 2026-06-07 by Joonas (TMB).
Ahrefs MCP & API FAQ
Is the Ahrefs MCP server official?+
Can I use the Ahrefs MCP with Cursor or Codex?+
Does Ahrefs have a public API?+
Which LLMs does Ahrefs integrate with directly?+
Sources
- Ahrefs official site: https://ahrefs.com/
- MCP server page: https://ahrefs.com/mcp/
- API docs: https://docs.ahrefs.com/
- Pricing source: https://ahrefs.com/pricing (verified 2026-06-07)
Data verified by Joonas on the dates shown. MCP server status auto-rechecked weekly.
10+ years in digital marketing. I review marketing software for AI-stack fit: real pricing, MCP and API support, and how cleanly each tool drops into an AI agent workflow, cross-checked against verified data and real user feedback.