Skip to main content
    My stack

    Plug Ahrefs into your assistant

    If you already pay for Ahrefs and spend too long exporting tables for clients, plug it in: your assistant queries keywords, links and rankings for you. Every question draws on your plan's units, so keep requests short and precise.

    In Ahrefs, your assistant can read, edit and delete your data. Plans: on Lite, Standard, Advanced and Enterprise plans, not on the free one. Connecting takes one click from Claude or ChatGPT.

    Official, published by Ahrefs · checked on 16 November 2026

    What changes for you

    Everyday situations, and what to write to your assistant.

    1. Client report

      The monthly report, no export needed.

      Using Ahrefs, which keywords did the Martin bakery's site gain or lose rankings on this month? Keep the ten that matter most.

    2. Competitor links

      A list of sites to pitch.

      Using Ahrefs, which sites link to my client's two main competitors but never to my client?

    3. Article ideas

      Topics built on real searches.

      Using Ahrefs, find what people search for before buying a coffee table and suggest five blog topics for my client.

    From one freelancer to another

    Ahrefs is a gold mine… with a meter at the entrance. Plugging in your assistant hands it the pickaxe: it digs into a client's keywords, a competitor's links, this month's rankings, and gives you an answer you can read. But every swing is paid for in units, and one overly broad question can take a real bite out of your monthly allowance. Here is how to dig in the right spot.

    What works

    • Start with “Using Ahrefs”

      Otherwise the assistant may search the web instead of your data. Ahrefs itself recommends this, especially in ChatGPT.

      Source: ahrefs.com
    • A number, a time range

      “The top ten keywords since last month” rather than “all my keywords”: the answer is sharper and the unit bill lighter.

      Source: help.ahrefs.com
    • A small sample is often enough

      One user who combed through their logs found that a short keyword list led to the same conclusion as a long one, for far fewer units. Widen only if it changes your decision.

      From user reports · studiomeyer.io
    • A starting point, not a verdict

      Ahrefs warns that the assistant can make things sound simpler than they are. Check the key figures in Ahrefs before they go into a client report.

      Source: ahrefs.com

    Where it falls short

    • An API key isn't an MCP key

      A 401 error often comes from an API key pasted instead of the MCP key, an expired key or a lapsed subscription. Workaround: generate an MCP key in Ahrefs, or use your assistant's official connector, which handles sign-in for you.

      Source: help.ahrefs.com
    • The meter that runs away

      One user reports that three tools, including link lists and keyword ideas, ate most of their units. Workaround: cap the number of results, estimate before a big batch, and watch your usage in your Ahrefs account settings.

      From user reports · studiomeyer.io
    • Results cut off silently

      Your plan caps the rows per request: an overly broad question gets truncated, not refused. Workaround: split by country, time range or top N, and sanity-check totals before drawing conclusions.

      From user reports · aitoolsreview.co.uk

    Plug in Ahrefs

    Pick your assistant: the steps follow.

    1. You need a paid Ahrefs plan.

    2. Open Ahrefs's page in Claude's directory and add the connector.

      Open in Claude
    3. Connect your Ahrefs account and read the access requested.

    4. Check it by asking:

      Which keywords did my site move up for this month?

    Depending on your plan. Your unit allowance and rows per request grow with the plan: 200,000 units and 100 rows on Lite.

    Stay in control

    The assistant never has more rights than your account.

    Your safeguards

    Each request has a cost

    Each request uses at least 50 API units, shared with the Ahrefs API: ask for short results.

    What it can do

    Ahrefs does not publish a readable tool list at the moment (its documentation pages return errors).

    ActionIdentifier
    Deletes data
    Delete social media posts.
    Edits your data
    Create and edit social media posts.
    Read onlyNo effect on your data
    Read SEO data: keywords, backlinks, rankings.

    Our view

    Useful if

    You pay for Ahrefs and track the search rankings of your site or your clients' sites.

    Less useful if

    You don't have a paid plan: the server is only available on paid plans.

    Going further

    Compare the 19 official MCP servers

    The guide to get started