Connect Ahrefs MCP to your AI Agents

Ask your Ahrefs SEO data anything — backlinks, keywords, and traffic.

Example prompts

Everything you can ask your agent about your Ahrefs data.

Ask in plain English — Sequel translates it into a Ahrefs query, runs it, and your agent hands back the answer. No SQL, no dashboards, no CSV exports.

Connect to your agent
What you can ask your agent
  • What's the domain rating and organic traffic for ahrefs.com?
  • Show the top 50 referring domains for competitor.com.
  • Which organic keywords does example.com rank for in the US top 10?
  • What's the search volume and difficulty for 'text to sql'?
  • List example.com's top pages by organic traffic.

Sequel CLI

Install Ahrefs MCP to your agent

The Sequel CLI installs Ahrefs into your coding agent in one step — it signs you in, provisions a scoped API key, and writes the right config to the right place. No keys to copy by hand.

Prefer npm? npm install -g @sequelsh/cli@latest works too.

  1. 1

    Install the Sequel CLI

    One line installs the latest CLI with whatever package manager you have.

    curl -fsSL https://sequel.sh/install | sh
  2. 2

    Sign in

    Authenticate in your browser and pick an organization.

    sequel login
  3. 3

    Install into your agent

    Run install and pick an agent from the list, or target one directly by its slug.

    sequel install
    • Claude Code
      sequel install claude-code
    • Claude
      sequel install claude
    • Cursor
      sequel install cursor
    • VS Code
      sequel install vscode
    • Windsurf
      sequel install windsurf
    • Zed
      sequel install zed
    • Codex
      sequel install codex
    • OpenClaw
      sequel install openclaw
    • Hermes
      sequel install hermes

Frequently asked questions

How do I connect Ahrefs to Sequel?

Create an API key in Ahrefs under Account settings → API keys (workspace owners and admins only), paste it into Sequel, and click Test. The key is sent to the Ahrefs API v3 as a Bearer token.

Do I need a specific Ahrefs plan?

The Ahrefs API is available on eligible paid plans. On other plans you still get a limited set of free test queries. See Ahrefs' pricing page for current API eligibility.

Can Sequel change anything in my Ahrefs account?

No. The connector only ships read-only reports (domain overview, backlinks, referring domains, organic keywords, top pages, keyword research). It cannot modify your Ahrefs projects or settings.

Will queries consume my Ahrefs API units?

Most reports cost Ahrefs API units (minimum 50 per request), billed against your plan's allowance. Validating your key is free. Use specific targets and small row limits to keep usage low.

Does Sequel store my Ahrefs data?

No. Report results are returned to your session and discarded; only your API key is stored, encrypted at rest. You can rotate or revoke it from Ahrefs at any time.

Can I combine Ahrefs with my other data sources?

Yes. Combine Ahrefs with Google Analytics or Search Console (SEO performance), or with your warehouse (organic traffic vs. revenue) and ask across all of them in a single question.

Start analyzing your Ahrefs data today

Connect in minutes — then ask across all your data, not just one source.