Marketing

Ahrefs MCP Server

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.

77 tools
Agent guide included
Start Chatting

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

Browse all tools

AI Skill
SKILL.md

Domain knowledge for Ahrefs — workflow patterns, data models, and gotchas for your AI agent.

Ahrefs API v3 (REST bundle)

Direct REST bundle for the Ahrefs v3 API at https://api.ahrefs.com/v3 (Site Explorer, Keywords Explorer, Rank Tracker, Web Analytics, etc.). For a hosted, OAuth-based alternative see the separate Ahrefs MCP provider.

Capabilities

  • Typed endpoints: One MCP tool per v3 route for Site Explorer, Keywords Explorer, Rank Tracker, management, batch analysis, brand radar, site audit, SERP overview, subscription limits, and public crawler metadata (same paths and HTTP methods as the ahrefs-python SDK).
  • Web Analytics: Four tools with closed enums—tabular reports (pick the report segment), site-wide summary chart, dimensional breakdown charts (optional values mapped to the correct Ahrefs query key per report), and UTM table vs chart.
  • Automation-friendly: field-based credentials—no browser OAuth round-trip (unlike the separate hosted Ahrefs MCP OAuth provider).
  • Raw access: Generic GET and mutate tools accept any relative v3 path when you need an escape hatch.

Data model

  • Targets — domains or URLs; mode / protocol scope how Ahrefs interprets the target.
  • Projects — Rank Tracker / workspace identifiers; report_id for Brand Radar and similar report-scoped APIs.
  • Dates — YYYY-MM-DD (and history ranges where documented).

Gotchas

  • Units: Most analytics calls consume API units; a few management reads are free per Ahrefs docs.
  • GET query lists: Pass arrays for multi-value fields; the bundle flattens them to comma-separated query values.
  • POST bodies: Non-GET tools send a JSON body from the tool arguments. If an edge case needs mixed query and body, use the raw mutate tool.

select column names

Each report has its own column identifiers. Site Explorer organic-keywords uses best_position and best_position_url for the ranking URL; position and a bare url column are not valid there. Rank Tracker overview uses position and url for tracked keywords instead. Organic-competitors uses keywords_common, not common_keywords. A wrong name yields HTTP 400 with the full allowed list in the response body.

Project ids (three concepts)

  • Rank Tracker / Web Analytics share a numeric project_id. List workspace projects from the management projects endpoint and match url to your site, or read the id from the Rank Tracker UI.
  • Site Audit uses a different project id namespace; copy it from the Site Audit UI. Most Site Audit reads need verified ownership. Crawl slices use YYYY-MM-DDThh:mm:ss timestamps; omit date to use the latest stored crawl.

Web Analytics arguments

Tabular and chart tools take to and from_ (trailing underscore): the MCP layer maps from_ to Ahrefs query parameter from because from is reserved in Python.

Versus hosted Ahrefs MCP

OAuth MCP and this bundle hit the same v3 surface; this bundle adds per-endpoint schemas in your tool list, key-based server automation, and generic v3 fallbacks without waiting for hosted tool discovery.

Tools in this Server (77)

Ahrefs Ba Batch Analysis Post

Ahrefs API v3 POST batch-analysis/batch-analysis.

Ahrefs Br Ai Responses

Ahrefs API v3 GET brand-radar/ai-responses.

Ahrefs Br Cited Domains

Ahrefs API v3 GET brand-radar/cited-domains.

Ahrefs Br Cited Pages

Ahrefs API v3 GET brand-radar/cited-pages.

Ahrefs Br Impressions History

Ahrefs API v3 GET brand-radar/impressions-history.

Ahrefs Br Impressions Overview

Ahrefs API v3 GET brand-radar/impressions-overview.

Ahrefs Br Mentions History

Ahrefs API v3 GET brand-radar/mentions-history.

Ahrefs Br Mentions Overview

Ahrefs API v3 GET brand-radar/mentions-overview.

Ahrefs Br Sov History

Ahrefs API v3 GET brand-radar/sov-history.

Ahrefs Br Sov Overview

Ahrefs API v3 GET brand-radar/sov-overview.

Ahrefs Get V3

GET any documented Ahrefs v3 endpoint: pass resource_path (section/endpoint) and optional query_params_json. Consumes API units on analytics endpoints...

Ahrefs Ke Matching Terms

Ahrefs API v3 GET keywords-explorer/matching-terms.

Ahrefs Ke Overview

Ahrefs API v3 GET keywords-explorer/overview.

Ahrefs Ke Related Terms

Ahrefs API v3 GET keywords-explorer/related-terms.

Ahrefs Ke Search Suggestions

Ahrefs API v3 GET keywords-explorer/search-suggestions.

Ahrefs Ke Volume By Country

Ahrefs API v3 GET keywords-explorer/volume-by-country.

Ahrefs Ke Volume History

Ahrefs API v3 GET keywords-explorer/volume-history.

Ahrefs Mg Brand Radar Prompts

Ahrefs API v3 GET management/brand-radar-prompts.

Ahrefs Mg Brand Radar Prompts Delete Put

Ahrefs API v3 PUT management/brand-radar-prompts-delete.

Ahrefs Mg Brand Radar Prompts Post

Ahrefs API v3 POST management/brand-radar-prompts.

Ahrefs Mg Keyword List Keywords

Ahrefs API v3 GET management/keyword-list-keywords.

Ahrefs Mg Keyword List Keywords Delete Put

Ahrefs API v3 PUT management/keyword-list-keywords-delete.

Ahrefs Mg Keyword List Keywords Put

Ahrefs API v3 PUT management/keyword-list-keywords.

Ahrefs Mg Locations

Ahrefs API v3 GET management/locations.

Ahrefs Mg Project Competitors

Ahrefs API v3 GET management/project-competitors.

Ahrefs Mg Project Competitors Delete Post

Ahrefs API v3 POST management/project-competitors-delete.

Ahrefs Mg Project Competitors Post

Ahrefs API v3 POST management/project-competitors.

Ahrefs Mg Project Keywords

Ahrefs API v3 GET management/project-keywords.

Ahrefs Mg Project Keywords Delete Put

Ahrefs API v3 PUT management/project-keywords-delete.

Ahrefs Mg Project Keywords Put

Ahrefs API v3 PUT management/project-keywords.

Ahrefs Mg Projects

Ahrefs API v3 GET management/projects.

Ahrefs Mg Projects Post

Ahrefs API v3 POST management/projects.

Ahrefs Mg Update Project Patch

Ahrefs API v3 PATCH management/update-project.

Ahrefs Mutate V3

POST, PUT, PATCH, or DELETE against documented Ahrefs v3 endpoints. Pass resource_path, http_method, optional query_params_json, and json_body for bod...

Ahrefs Pub Crawler Ip Ranges

Ahrefs API v3 GET public/crawler-ip-ranges.

Ahrefs Pub Crawler Ips

Ahrefs API v3 GET public/crawler-ips.

Ahrefs Rt Competitors Overview

Ahrefs API v3 GET rank-tracker/competitors-overview.

Ahrefs Rt Competitors Pages

Ahrefs API v3 GET rank-tracker/competitors-pages.

Ahrefs Rt Competitors Stats

Ahrefs API v3 GET rank-tracker/competitors-stats.

Ahrefs Rt Overview

Ahrefs API v3 GET rank-tracker/overview.

Ahrefs Rt Serp Overview

Ahrefs API v3 GET rank-tracker/serp-overview.

Ahrefs Sa Issues

Ahrefs API v3 GET site-audit/issues.

Ahrefs Sa Page Content

Ahrefs API v3 GET site-audit/page-content.

Ahrefs Sa Page Explorer

Ahrefs API v3 GET site-audit/page-explorer.

Ahrefs Sa Projects

Ahrefs API v3 GET site-audit/projects.

Ahrefs Se All Backlinks

Ahrefs API v3 GET site-explorer/all-backlinks.

Ahrefs Se Anchors

Ahrefs API v3 GET site-explorer/anchors.

Ahrefs Se Backlinks Stats

Ahrefs API v3 GET site-explorer/backlinks-stats.

Ahrefs Se Broken Backlinks

Ahrefs API v3 GET site-explorer/broken-backlinks.

Ahrefs Se Domain Rating

Ahrefs API v3 GET site-explorer/domain-rating.

Ahrefs Se Domain Rating History

Ahrefs API v3 GET site-explorer/domain-rating-history.

Ahrefs Se Keywords History

Ahrefs API v3 GET site-explorer/keywords-history.

Ahrefs Se Linked Anchors External

Ahrefs API v3 GET site-explorer/linked-anchors-external.

Ahrefs Se Linked Anchors Internal

Ahrefs API v3 GET site-explorer/linked-anchors-internal.

Ahrefs Se Linkeddomains

Ahrefs API v3 GET site-explorer/linkeddomains.

Ahrefs Se Metrics

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...

Ahrefs Se Metrics By Country

Ahrefs API v3 GET site-explorer/metrics-by-country.

Ahrefs Se Metrics History

Ahrefs API v3 GET site-explorer/metrics-history.

Ahrefs Se Organic Competitors

Ahrefs API v3 GET site-explorer/organic-competitors.

Ahrefs Se Organic Keywords

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...

Ahrefs Se Outlinks Stats

Ahrefs API v3 GET site-explorer/outlinks-stats.

Ahrefs Se Pages By Backlinks

Ahrefs API v3 GET site-explorer/pages-by-backlinks.

Ahrefs Se Pages By Internal Links

Ahrefs API v3 GET site-explorer/pages-by-internal-links.

Ahrefs Se Pages By Traffic

Ahrefs API v3 GET site-explorer/pages-by-traffic.

Ahrefs Se Pages History

Ahrefs API v3 GET site-explorer/pages-history.

Ahrefs Se Paid Pages

Ahrefs API v3 GET site-explorer/paid-pages.

Ahrefs Se Refdomains

Ahrefs API v3 GET site-explorer/refdomains.

Ahrefs Se Refdomains History

Ahrefs API v3 GET site-explorer/refdomains-history.

Ahrefs Se Top Pages

Ahrefs API v3 GET site-explorer/top-pages.

Ahrefs Se Total Search Volume History

Ahrefs API v3 GET site-explorer/total-search-volume-history.

Ahrefs Se Url Rating History

Ahrefs API v3 GET site-explorer/url-rating-history.

Ahrefs Sov Serp Overview

Ahrefs API v3 GET serp-overview/serp-overview.

Ahrefs Sub Limits And Usage

Ahrefs API v3 GET subscription-info/limits-and-usage.

Ahrefs Wa Breakdown Chart

Ahrefs Web Analytics: dimensional breakdown chart. Picks one of 15 GET *-chart endpoints; optional values_to_chart is sent under the Ahrefs parameter ...

Ahrefs Wa Summary Chart

Ahrefs Web Analytics: site-wide time-series chart (GET web-analytics/chart).

Ahrefs Wa Table Report

Ahrefs Web Analytics: tabular breakdown report. Chooses one of 16 GET endpoints under web-analytics/ (browsers, cities, sources, top pages, etc.) via ...

Ahrefs Wa Utm Report

Ahrefs Web Analytics: UTM dimension table or chart (GET utm-params / utm-params-chart). Use report_format=chart with granularity; optional values_to_c...

Frequently Asked Questions

What is the Ahrefs MCP server?

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).

How do I connect Ahrefs to my AI agent?

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.

How many tools does Ahrefs provide?

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.

What authentication does Ahrefs require?

Ahrefs uses API Key. Ahrefs requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Ahrefs to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/ahrefs

What is MCP?

Model Context Protocol lets AI tools call external capabilities securely through a single URL. This bundle groups tools behind an MCP endpoint that many clients can use.

Use this bundle in 3 steps

  1. Copy the MCP URL above
  2. Open your AI tool and add a new MCP/connector
  3. Paste the URL and follow any auth prompts

Claude Desktop Users

Skip the manual setup! Use the .mcpb file format for one-click installation. Check the Claude Desktop tab for setup instructions.

Pick your tool tab for exact steps

Select ChatGPT, Cursor, Claude Code, or another tab for copy-paste config.

Related MCP Servers

More marketing integrations you might like

ActiveCampaign

ActiveCampaign is an email marketing, marketing automation, and customer experience automation platf...

6 tools
Marketing
AdAdvisor

The AdAdvisor MCP Server offers tools for managing advertising campaigns, including keyword manageme...

Marketing
Adspirer

This server provides tools to manage advertising campaigns across major platforms such as Google, Me...

Marketing
Agent Analytics

Agent Analytics provides insights and performance metrics for AI agents, enabling users to analyze t...

Marketing
Ahrefs

Ahrefs MCP server for SEO and site audit tooling.

Marketing
Apify

Apify is a web scraping and automation platform that enables developers and businesses to extract da...

Marketing

Ready to use Ahrefs?

Sign in to connect your credentials and start running tools from the chat.

Ahrefs MCP Server & Skill — 77 Tools