Connect your account, then chat with AI to run tools.
Ahrefs SEO over REST v3: 75 typed tools covering the official ahrefs-python v3 surface (Site Explorer, Keywords Explorer, Rank Tracker, Brand Radar, Site Audit, SERP overview, batch analysis, management, public metadata) plus four enum-driven Web Analytics tools (tabular, summary chart, breakdown charts, UTM) and raw GET/mutate helpers. Dashboard API key (Bearer) against api.ahrefs.com/v3.
Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.
Browse all toolsDomain knowledge for Ahrefs — workflow patterns, data models, and gotchas for your AI agent.
Operating notes that the typed schemas alone won't tell the agent. Tool descriptions cover routes and parameter types; this skill covers the cross-tool semantics, the ID namespaces, and the column-name traps.
The Rank Tracker and Brand Radar write endpoints (add/delete competitors, add/delete tracked keywords, add/delete brand radar prompts, add/delete keyword-list keywords) place project_id / report_id / keyword_list_id in the query string. The body carries only the payload (the competitors, the keywords, the prompts). The lone exception is the project access PATCH, which keeps project_id in the body. The typed tools handle this routing automatically — agents only need to pass the id as a normal argument.
Competitors and tracked keywords are object arrays, not string arrays.
Keyword-list writes (the standalone keyword_list_id surface, distinct from project tracked keywords) take a flat keywords: ["..."] string array.
Each Ahrefs report has its own column identifiers and the wrong name yields HTTP 400 with the full allowed list in the response body. Three traps that bite repeatedly:
Web Analytics tabular and chart tools accept to and from_ (trailing underscore). The trailing underscore is a Python keyword workaround; the request that goes to Ahrefs uses the documented from name. Use from_ in the tool argument; the request sent to Ahrefs uses the plain from name.
Most analytics calls consume API units against the workspace's monthly limit. The subscription limits and usage tool reports the current consumption. Management reads (list projects, list competitors, list keywords, locations and languages, keyword lists) are free; project/competitor/keyword writes are also free per Ahrefs documentation. Site Explorer, Keywords Explorer, Brand Radar, and Web Analytics reads cost units per row returned — apply limit aggressively when scanning.
When asked about "ranking for a site" without an id, list projects first, match the URL, then read tracked keywords or call Site Explorer with the domain directly (Site Explorer does not require a project_id — it takes a target domain or URL plus a mode/protocol scope).
Pull selected SEO metrics for a batch of up to 200 targets (domains or URLs) in one call. ``targets`` is a list of objects, each with ``target`` (doma...
Return raw AI-search engine responses (ChatGPT, Perplexity, Gemini, Google AI Overview, etc.) captured for the prompts tracked in a Brand Radar report...
Return the external domains that AI search engines are citing alongside (or instead of) the tracked brand for the report's prompts, with citation coun...
Return the individual pages (URLs) that AI search engines cite in answers to the report's prompts, with citation counts. One step deeper than the cite...
Time-series of AI-search impressions (the brand was mentioned or cited in an answer) for the report's tracked prompts, bucketed by day. Use this to ch...
Aggregated total of AI-search impressions for the report's tracked prompts over the given window — one number you can put on a dashboard. Use the impr...
Time-series of brand *mentions* (the brand name appeared in the answer text) for the report's prompts, bucketed by day. ``Mention`` differs from ``cit...
Aggregated total of AI-search mentions of the brand for the report's prompts over the given window. Use the mentions-history sibling for the daily ser...
Time-series of share-of-voice across AI search engines: the percentage of answers to the report's tracked prompts that mention or cite the brand vs. c...
Aggregated share-of-voice for the brand across AI search engines over the given window — one number per engine/country, plus the competing brands' sha...
Escape-hatch GET against any documented Ahrefs v3 endpoint when no typed tool covers it (or when a new endpoint hasn't been wired up yet). ``resource_...
Return keywords that contain the seed term as a substring or phrase match — Ahrefs's Keywords Explorer 'Matching terms' report. Use this to expand a s...
Return Keywords Explorer overview metrics for one or many keywords: monthly search volume, Keyword Difficulty (KD), CPC, traffic potential of the top-...
Return keywords *semantically* related to the seed term — Ahrefs's 'Related terms' report. Casts a wider net than matching-terms (which is a substring...
Return Google-autocomplete-style suggestions that *start with* the seed phrase — the phrases users actually type when their query begins with this wor...
Return per-country search volume for a single keyword — every country Ahrefs has data for, with each country's monthly volume. Use this to decide whic...
Return monthly search-volume time series for a single keyword over the requested history window. Use this to detect seasonality (e.g. ``halloween cost...
List the AI-search prompts currently tracked in a Brand Radar report, with each prompt's text, country scope, and id. ``report_id`` (numeric, from the...
Remove tracked AI-search prompts from a Brand Radar report. ``report_id`` (numeric) selects the report; ``prompts`` is the list of prompt strings to d...
Add custom AI-search prompts to an existing Brand Radar report so Ahrefs starts tracking the report's brand presence in answers to those prompts acros...
Return the keywords stored in a saved Keywords Explorer keyword list, with the list's metadata. ``keyword_list_id`` (numeric) selects the list. Use th...
Remove keywords from a saved Keywords Explorer keyword list. ``keyword_list_id`` (numeric) selects the list and ``keywords`` is the flat array of keyw...
Append keywords to a saved Keywords Explorer keyword list. ``keyword_list_id`` (numeric) selects the list — discover it via the matching read tool. ``...
Return the list of locations Ahrefs supports for a given country: country/region/city labels with their numeric ``location_id`` and ``language_code``....
List the competitors currently tracked for a Rank Tracker project: each row has ``url`` and ``mode`` (``domain`` / ``subdomains`` / ``exact`` / ``pref...
Remove tracked competitors from a Rank Tracker project. ``project_id`` is the numeric Rank Tracker project id; ``competitors`` is an object array of i...
Add competitors to a Rank Tracker project so Ahrefs starts collecting their tracked-keyword rankings alongside the project's own. ``project_id`` is th...
List the keywords currently tracked in a Rank Tracker project. Each row has the keyword text, location id, language, country, and tags. One keyword tr...
Remove tracked keywords from a Rank Tracker project. ``project_id`` is the numeric Rank Tracker project id; ``keywords`` is an object array of ``{keyw...
Add tracked keywords to a Rank Tracker project. ``project_id`` is the numeric Rank Tracker project id; ``locations`` is an object array of ``{country,...
List the workspace's Rank Tracker / Web Analytics projects with their numeric ``project_id``, tracked URL, mode, access, ownership, and whether they h...
Create a new Rank Tracker / Web Analytics project. ``url`` is the target site, ``protocol`` is ``http`` or ``https``, ``mode`` is the target scope (``...
Change the ``access`` setting of a Rank Tracker / Web Analytics project to ``private`` or ``public``. ``project_id`` (numeric) selects the project. No...
Escape-hatch write (POST / PUT / PATCH / DELETE) against any documented Ahrefs v3 endpoint when no typed write tool covers it. ``resource_path`` is th...
Return the published CIDR ranges that AhrefsBot crawls from. Use this when configuring firewall, WAF, or robots.txt allow-rules so Ahrefs's crawler is...
Return the explicit individual IP addresses currently in use by AhrefsBot. Prefer the sibling crawler-ip-ranges tool for CIDR-based allowlisting; use ...
Return aggregated rank-tracker stats for the project's tracked competitors and the project itself: average position, share-of-voice, visibility %, tra...
Return per-page rankings for the project's tracked competitors — which exact URLs rank for which tracked keywords, with positions and traffic estimate...
Side-by-side rank-bucket summary for the project's tracked competitors: keyword counts in positions 1-3, 4-10, 11-20, 21-50, 51-100, plus average posi...
Return per-keyword rankings for the project itself (not competitors). One row per tracked keyword × location: ``position`` (current rank), ``url`` (th...
For each keyword tracked in the project, return the SERP top-10 organic results plus the SERP features rendered (AI Overview, Featured Snippet, People...
Aggregate technical-SEO issue summary for a Site Audit crawl: counts of broken links, 4xx/5xx pages, redirect chains, missing titles/descriptions, slo...
Return the captured rendered content of one URL from a Site Audit crawl: title, meta description, H1/H2 structure, canonical, OpenGraph/Twitter tags, ...
Filterable list of every page in a Site Audit crawl with its full set of crawl metrics (status code, content type, HTTP/HTTPS, canonical, indexability...
List the workspace's Site Audit projects with their numeric ``project_id``, target URL, last crawl timestamp, and ownership-verification status. Site ...
Return individual backlinks pointing to the target — one row per link with source URL, anchor text, target URL, dofollow/nofollow, link type (text / i...
Return the anchor-text distribution of incoming backlinks to the target: each distinct anchor phrase with its referring-page count, referring-domain c...
Aggregate backlink counters for the target: total backlinks, dofollow backlinks, referring domains, referring IPs, referring subnets, plus new vs lost...
Return backlinks pointing to pages on the target that currently 4xx or 5xx — a list of broken-link reclamation opportunities. Each row has the source ...
Return the target's current Domain Rating (DR) — Ahrefs's 0-100 estimate of domain-level backlink authority — plus the inputs used to compute it (dofo...
Return Domain Rating (DR) over time for the target — a daily/weekly time series. Use to chart whether the target's overall backlink authority is trend...
Time series of the target's organic-keyword count: how many keywords the target ranked for in each historical period. Use to chart organic visibility ...
Return the anchor texts the target uses on its **outbound** external links (links *from* the target *to* other sites). Each row is one anchor phrase w...
Return the anchor texts the target uses on its **internal** links (target → target navigation). Each row is one anchor phrase with the count of intern...
Return the external domains the target links *to* (outbound link partners), with the number of pages on the target that link to each one and total dof...
Ahrefs Site Explorer snapshot metrics for a domain or URL on a given day (organic/paid counts, traffic estimates, etc.). No select argument—Ahrefs ret...
Return the headline SEO metrics (organic traffic, organic keywords, traffic value) broken down by country — one row per country Ahrefs has data for. U...
Time series of the target's headline SEO metrics: organic traffic, organic keywords, and traffic value over the requested history window. Use to chart...
Return the domains that rank for the same organic keywords as the target — Ahrefs's organic-competitors discovery report. Each row has the competitor ...
Site Explorer: organic search terms a domain or URL ranks for on a given day. Use best_position and best_position_url in select for ranking URL—not th...
Aggregate counters for the target's outbound links: total external links, dofollow external links, unique linked-to domains, and internal-vs-external ...
Return the target's pages ranked by inbound-backlink count — which URLs on the target attract the most links. Each row has the page URL, total backlin...
Return the target's pages ranked by **internal**-link count — which URLs on the target receive the most internal links from other pages on the same si...
Return the target's pages ranked by estimated organic search traffic. Each row has the page URL, traffic, top organic keyword, position for that keywo...
Time series of the target's indexed-page count over the requested history window. Use to chart whether the site is growing or pruning content; pair wi...
Return the target's pages running paid search ads (Google Ads / Bing Ads), with estimated paid traffic, paid keywords driving the page, and paid traff...
Return the **inbound** referring domains that link to the target — one row per linking domain (deduped, unlike all-backlinks which is one row per link...
Time series of referring-domain count for the target over the history window. Use to chart whether the target's link-acquisition rate is steady, accel...
Return the target's top organic-traffic pages — the canonical 'best pages on this site' report. Each row has the page URL, estimated organic traffic, ...
Time series of the *total* monthly search volume across every keyword the target ranks for, over the history window. Use this to detect demand-side sh...
Time series of URL Rating (URL-level authority, 0-100) for a specific URL over the history window — the page-level companion to domain-rating-history....
Standalone SERP overview for any keyword (not tied to a Rank Tracker project): the live top-10 organic results, the SERP features rendered (AI Overvie...
Return the workspace's Ahrefs subscription tier, monthly API unit limit, current consumption (workspace-wide and per API key), units-reset date, and A...
Ahrefs Web Analytics: dimensional breakdown chart. Picks one of 15 GET *-chart endpoints; optional values_to_chart is sent under the Ahrefs parameter ...
Ahrefs Web Analytics: site-wide time-series chart (GET web-analytics/chart).
Ahrefs Web Analytics: tabular breakdown report. Chooses one of 16 GET endpoints under web-analytics/ (browsers, cities, sources, top pages, etc.) via ...
Ahrefs Web Analytics: UTM dimension table or chart (GET utm-params / utm-params-chart). Use report_format=chart with granularity; optional values_to_c...
Ahrefs SEO over REST v3: 75 typed tools covering the official ahrefs-python v3 surface (Site Explorer, Keywords Explorer, Rank Tracker, Brand Radar, Site Audit, SERP overview, batch analysis, management, public metadata) plus four enum-driven Web Analytics tools (tabular, summary chart, breakdown charts, UTM) and raw GET/mutate helpers. Dashboard API key (Bearer) against api.ahrefs.com/v3. It provides 77 tools that AI agents can use through the Model Context Protocol (MCP).
Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/ahrefs. Authentication is handled automatically.
Ahrefs provides 77 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.
Ahrefs uses API Key. Ahrefs requires credentials. Connect via MCPBundles and authentication is handled automatically.
Connect Ahrefs to any MCP client in minutes
The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.
Ahrefs and paste the MCP URL into Remote MCP server URL.Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).
More marketing integrations you might like
ActiveCampaign is an email marketing, marketing automation, and customer experience automation platf...
The AdAdvisor MCP Server offers tools for managing advertising campaigns, including keyword manageme...
This server provides tools to manage advertising campaigns across major platforms such as Google, Me...
Agent Analytics provides insights and performance metrics for AI agents, enabling users to analyze t...
Ahrefs MCP server for SEO and site audit tooling.
Apify is a web scraping and automation platform that enables developers and businesses to extract da...