Ahrefs MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Ahrefs MCP or direct API to analyze backlinks, track rankings, research keywords, and compare competitors through natural language.

Ahrefs MCP logoAhrefs MCP
Dcr Oauth

Ahrefs MCP is Ahrefs' hosted MCP server for SEO data and insights. Use it to access backlinks, organic metrics, keyword research, and competitor analysis.

134 Tools

Try Ahrefs MCP now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Ahrefs MCP
Try asking
TOOLS

Supported Tools

Every Ahrefs MCP action and event your agent gets out of the box.

Batch-analysis

Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics.

Brand-radar-ai-responses

Provides questions asked to AI assistants and the corresponding AI-generated responses that mention your brand or competitors’ brands, including cited sources and search volume estimates.

Brand-radar-ai-responses-entities

Provides questions asked to AI assistants and the corresponding AI-generated responses that mention your brand or competitors’ brands, including cited sources and search volume estimates.

Brand-radar-citations-history-entities

Provides the historical number of citations for your and competitors' brand URLs in an LLM you specify.

Brand-radar-citations-overview-entities

Provides the number of citations for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-cited-domains

Provides domains cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each domain (broken down by brand) and estimated monthly search volume where each domain was mentioned.

Brand-radar-cited-domains-entities

Provides domains cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each domain (broken down by brand) and estimated monthly search volume where each domain was mentioned.

Brand-radar-cited-pages

Provides the pages cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each page (broken down by brand) and estimated monthly search volume where each page was mentioned.

Brand-radar-cited-pages-entities

Provides the pages cited in AI-generated responses that mention your brand or competitors' brands in an LLM you specify, including how many responses referenced each page (broken down by brand) and estimated monthly search volume where each page was mentioned.

Brand-radar-impressions-history

Provides the historical number of impressions for your and competitors's brands in an LLM you specify.

Brand-radar-impressions-history-entities

Provides the historical number of impressions for your and competitors's brands in an LLM you specify.

Brand-radar-impressions-overview

Provides the number of impressions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-impressions-overview-entities

Provides the number of impressions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-mentions-history

Provides the historical number of mentions for your and competitors's brands in an LLM you specify.

Brand-radar-mentions-history-entities

Provides the historical number of mentions for your and competitors's brands in an LLM you specify.

Brand-radar-mentions-overview

Provides the number of mentions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-mentions-overview-entities

Provides the number of mentions for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-sov-history

Provides the historical share of voice for your and competitors's brands in an LLM you specify.

Brand-radar-sov-history-entities

Provides the historical share of voice for your and competitors's brands in an LLM you specify.

Brand-radar-sov-overview

Provides the share of voice for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Brand-radar-sov-overview-entities

Provides the share of voice for your and competitors's brands in an LLM you specify, with filters for locations, query text, URL, and more.

Doc

Full documentation for Ahrefs API v3 and the corresponding MCP tools.

Gsc-anonymous-queries

Returns organic keywords that rank for the project but are not reported by Google Search Console (anonymized queries), with position, traffic, volume, and CPC data.

Gsc-ctr-by-position

Returns Google Search Console CTR (click-through rate) data by keyword position, showing each keyword's average position, CTR percentage, and click count.

Gsc-keyword-history

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific keywords over time, grouped by daily, weekly, or monthly intervals.

Gsc-keywords

Returns Google Search Console keywords table data with metrics (clicks, impressions, CTR, position) and associated URLs for a project.

Gsc-metrics-by-country

Returns Google Search Console click metrics grouped by country for a project.

Gsc-page-history

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific pages over time, grouped by daily, weekly, or monthly intervals.

Gsc-pages

Returns Google Search Console pages table data with metrics (clicks, impressions, CTR, position) and associated keywords for a project.

Gsc-pages-history

Returns Google Search Console pages chart data showing total indexed pages over time for a project.

Gsc-performance-by-device

Returns Google Search Console performance metrics (clicks, impressions, CTR, position) broken down by device type (desktop, mobile, tablet) for a project.

Gsc-performance-by-position

Returns Google Search Console performance metrics (clicks, impressions, keyword count) grouped by position ranges (1-3, 4-10, 11-20, 21-50, 51+) for a project.

Gsc-performance-history

Returns Google Search Console performance chart data (clicks, impressions, CTR, position) for a project over time, grouped by daily, weekly, or monthly intervals.

Gsc-positions-history

Returns Google Search Console keyword count data grouped by position ranges (1-3, 4-10, 11-20, 21-50, 51+) over time for a project.

Keywords-explorer-matching-terms

Retrieves keyword ideas and their associated SEO metrics by matching input terms or phrases in a specified country, with extensive support for filtering, sorting, and metric selection.

Keywords-explorer-overview

Provides an overview of keyword metrics—including search volume, CPC, ranking difficulty, traffic potential, and intent—for specified keywords, domains, or URLs within a given country.

Keywords-explorer-related-terms

Returns keyword metrics and related terms—such as "also rank for" keywords and "also talk about" keywords—for a given keyword or keyword list, with filtering and sorting options.

Keywords-explorer-search-suggestions

Provides keyword search suggestions and related keyword metrics (e.

Keywords-explorer-volume-by-country

Retrieves search volume metrics for a specified keyword broken down by country.

Keywords-explorer-volume-history

Retrieves historical search volume data for a specified keyword within a given country and date range.

Management-brand-radar-prompts

Retrieves custom prompts for a specific brand radar report.

Management-brand-radar-reports

Retrieves the list of custom brand radar reports.

Management-keyword-list-keywords

Retrieves keywords from a keyword list.

Management-locations

Retrieves a list of management locations filtered by country code and optionally by US state.

Management-project-competitors

Retrieves the list of competitors associated with a specific Rank Tracker project in Ahrefs, using the project's unique identifier.

Management-project-keywords

Returns all tracked keywords for a specific Rank Tracker project, including associated tracking metadata.

Management-projects

Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID.

Public-crawler-ip-ranges

Returns the IP ranges used by the Ahrefs public web crawler, typically for allowlisting or firewall configuration.

Public-crawler-ips

Returns the list of individual IP addresses currently used by the Ahrefs public web crawler.

Public-domain-rating-free

Retrieves the domain rating for a specified domain or URL as of today.

Public-domain-rating-top-domains

Returns the top 1M domains ranked by Ahrefs Domain Rating, together with each domain's current Domain Rating.

Rank-tracker-competitors-domains

Provides an overview of competitor domains and their share of voice for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data.

Rank-tracker-competitors-overview

Provides an overview of competitor rankings and keyword metrics for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data.

Rank-tracker-competitors-pages

Provides an overview of competitor pages and keyword metrics for a specified project and date in Ahrefs Rank Tracker, allowing comparison between current and previous data.

Rank-tracker-competitors-stats

Provides an overview of competitor metrics for a specified project and date in Ahrefs Rank Tracker.

Rank-tracker-overview

Provides an overview of tracked keyword rankings and related search metrics for a specified project and date, with support for historical comparison, filtering, column selection, and device type.

Rank-tracker-serp-overview

Returns SERP overview for a specified keyword in a Rank Tracker project, showing detailed information about each position including title, URL, type, backlink metrics, and traffic data.

Render-data-table

Render an interactive data table widget with sorting, search, and pagination.

Render-scorecard

Render a scorecard widget showing key metrics as a card grid.

Render-time-series-chart

Render an interactive time series line chart.

Serp-overview

Returns an overview of the top search results (SERP) for a specified keyword and country, including detailed metrics about each result like position, backlinks, traffic, domain rating, and related keywords.

Site-audit-issues

Returns all issues from your Site Audit crawl.

Site-audit-page-content

Returns the HTML and extracted text content of a page from your Site Audit crawl.

Site-audit-page-explorer

Returns detailed information about pages discovered in a Site Audit project, including URLs, crawl metadata, and selected on-page metrics.

Site-audit-projects

Returns Site Audit project summaries (all projects or a specific project), including health scores, issue counts, and crawled page counts for the latest crawl or a specified historical point in time.

Site-explorer-ai-responses-count

Returns how often AI search platforms cite the target, with the number of citation links and distinct cited pages per platform as of a given date.

Site-explorer-all-backlinks

Retrieves detailed information about all backlinks pointing to a specified URL or domain, with extensive filtering, sorting, selection, and aggregation options.

Site-explorer-anchors

Retrieves anchor text and associated backlink metrics for a specified domain or URL, with filtering and selection options.

Site-explorer-backlinks-stats

Provides backlink statistics for a specified URL or domain as of a given date, with options to control protocol and scope.

Site-explorer-broken-backlinks

Retrieves a list of broken backlinks (i.

Site-explorer-crawled-pages

Returns a list of pages crawled by Ahrefs for a specified domain or URL, including the page URLs.

Site-explorer-domain-rating

Retrieves the domain rating and related metrics for a specified domain or URL as of a specific date.

Site-explorer-domain-rating-history

Retrieves the historical domain rating data for a specified domain or URL over a defined date range and grouping interval.

Site-explorer-keywords-history

Retrieves historical data on the number of organic keywords a specified website or URL has ranked for, segmented by various search position ranges and grouped by a chosen time interval.

Site-explorer-linked-anchors-external

Retrieves data about external anchor text (the clickable words in outbound links) used on a specified domain, subdomain, or URL, including metrics like dofollow link counts, distinct linked domains, and other attributes about the links.

Site-explorer-linked-anchors-internal

Retrieves internal anchor text data for a given website or URL, detailing how anchor texts are used in links between pages on the same site.

Site-explorer-linked-domains

Retrieves information about external domains that are linked from a specified target domain or URL, allowing for filtering, field selection, and various scopes of analysis.

Site-explorer-metrics

Provides SEO performance metrics for a specified domain, URL, or site section as of a given date, with options to customize search scope, protocol, country, and search volume mode.

Site-explorer-metrics-by-country

Provides organic and paid search performance metrics for a specified website, broken down by country, for a specific date.

Site-explorer-metrics-history

Retrieves historical data on key organic and paid search traffic and cost metrics for a specified domain, URL, or path over a selectable date range and grouping interval.

Site-explorer-organic-competitors

Retrieves a list of organic search competitors for a specified website or URL, providing comparative SEO metrics such as common keywords, traffic estimations, and domain strength for a chosen country and date.

Site-explorer-organic-keywords

Retrieves detailed organic keyword data for a given domain, URL, or path, including rankings, search intent, SERP features, traffic and CPC metrics, with the ability to filter, sort, and compare metrics across dates and regions.

Site-explorer-outlinks-stats

Retrieves statistical data about the outbound links (outlinks) from a specified URL, domain, or site section.

Site-explorer-pages-by-backlinks

Returns a list of a site's or URL's best-performing pages, ranked by the number of referring external links, with flexible filtering and sorting options.

Site-explorer-pages-by-internal-links

Retrieves a site's or page's internal link metrics, allowing analysis of how pages within the given domain or URL are interconnected and which pages receive the most internal links.

Site-explorer-pages-by-traffic

Returns the distribution of pages by estimated organic traffic buckets for a specified domain or URL, across all locations or for a specified country.

Site-explorer-pages-history

Retrieves historical data about pages from a specified domain, URL, or section of a site, grouped by a chosen time interval.

Site-explorer-paid-pages

Returns detailed metrics about pages on a specified site or URL that are ranking in paid search results, including traffic, keyword data, ad presence, and changes over time, with powerful filtering and comparison capabilities.

Site-explorer-refdomains-history

Provides historical data on referring domains linking to a specified target (domain or URL) over a defined date range, with customizable grouping and analysis scope.

Site-explorer-referring-domains

Retrieves detailed information about referring domains that link to a specified target domain or URL, with flexible filtering, selection, and sorting of backlink-related metrics.

Site-explorer-top-pages

Returns a list of the top-performing pages for a specified website or URL, including detailed SEO metrics (such as organic rankings, traffic, top keyword, and changes over time), with support for comparison between two dates and flexible filtering.

Site-explorer-total-search-volume-history

Returns historical totals of search volume for keywords that the specified domain or URL ranks for in the top 10 or top 100 results, across all countries or for a specified country.

Site-explorer-url-rating-history

Retrieves the historical URL rating data for a specified domain or URL over a defined date range, grouped by a chosen time interval.

Social-media-activity-history

Get the activity history log for posts (published, scheduled, failed, etc.

Social-media-authors

List users who have created posts in the account.

Social-media-channel-metrics

Get historical follower count data for connected channels.

Social-media-channels

List social media channels with their connection status and metadata.

Social-media-post-metrics

Get engagement metrics (views, likes, etc.

Social-media-posts

List social media posts with filtering by channel, status, and author.

Subscription-info-limits-and-usage

Retrieves subscription information including limits and usage statistics for API units, workspace quotas, and API key details.

Web-analytics-browsers

Returns browser statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser.

Web-analytics-browsers-chart

Returns time-series chart data grouped by browser for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-browser-versions

Returns browser version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser version.

Web-analytics-browser-versions-chart

Returns time-series chart data grouped by browser version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-chart

Returns time-series chart data for aggregate statistics of a Web Analytics project, with metrics like pageviews, visitors, visits, bounce rate, and session duration at the specified granularity.

Web-analytics-cities

Returns visitor data grouped by city for a Web Analytics project, showing visitor counts for each location.

Web-analytics-cities-chart

Returns time-series chart data grouped by city for a Web Analytics project, showing visitor counts over time for each location.

Web-analytics-continents

Returns visitor data grouped by continent for a Web Analytics project, showing visitor counts for each region.

Web-analytics-continents-chart

Returns time-series chart data grouped by continent for a Web Analytics project, showing visitor counts over time for each region.

Web-analytics-countries

Returns visitor data grouped by country for a Web Analytics project, showing visitor counts for each location.

Web-analytics-countries-chart

Returns time-series chart data grouped by country for a Web Analytics project, showing visitor counts over time for each location.

Web-analytics-devices

Returns device type statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by device type.

Web-analytics-devices-chart

Returns time-series chart data grouped by device type for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-entry-pages

Returns entry page statistics for a Web Analytics project, showing which pages visitors land on first, including visitor counts and entry rates.

Web-analytics-entry-pages-chart

Returns time-series chart data for entry pages of a Web Analytics project, showing visitor counts and entry rates over time.

Web-analytics-exit-pages

Returns exit page statistics for a Web Analytics project, showing which pages visitors leave from, including visitor counts and exit rates.

Web-analytics-exit-pages-chart

Returns time-series chart data for exit pages of a Web Analytics project, showing visitor counts and exit rates over time.

Web-analytics-languages

Returns visitor data grouped by browser language for a Web Analytics project, showing visitor counts for each language.

Web-analytics-languages-chart

Returns time-series chart data grouped by browser language for a Web Analytics project, showing visitor counts over time for each language.

Web-analytics-operating-systems

Returns operating system statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS.

Web-analytics-operating-systems-chart

Returns time-series chart data grouped by operating system for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-operating-systems-versions

Returns OS version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS version.

Web-analytics-operating-systems-versions-chart

Returns time-series chart data grouped by OS version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-referrers

Returns referrer statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referrer URL.

Web-analytics-referrers-chart

Returns time-series chart data grouped by referrer for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Web-analytics-source-channels

Returns traffic grouped by source channel (e.

Web-analytics-source-channels-chart

Returns time-series chart data grouped by source channel (e.

Web-analytics-sources

Returns traffic source breakdown for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referral source.

Web-analytics-sources-chart

Returns time-series chart data for traffic sources of a Web Analytics project, showing how visitor counts, bounce rates, and session durations change over time for each referral source.

Web-analytics-stats

Returns aggregate statistics for a Web Analytics project, including total visitors, bounce rate, and average session duration without any dimension grouping.

Web-analytics-top-pages

Returns the most visited pages for a Web Analytics project, including pageview counts, visitor counts, bounce rates, and average page visit durations.

Web-analytics-top-pages-chart

Returns time-series chart data for the most visited pages of a Web Analytics project, showing how pageviews, visitors, and other metrics change over time.

Web-analytics-utm-params

Returns statistics for a specified UTM paramater for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by utm_source.

Web-analytics-utm-params-chart

Returns time-series chart data grouped by a specified UTM param for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

SETUP GUIDE

Connect Ahrefs MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
Install the Composio SDK for Python or TypeScript
2

Initialize Client and Create Tool Router Session

typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
Import and initialize the Composio client, then create a Tool Router session for Ahrefs MCP
3

Connect to AI Agent

typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
Use the MCP server with your AI agent (Anthropic Claude or Mastra)
SETUP GUIDE

Connect Ahrefs MCP API Tool with your Agent

1

Install Composio

typescript
npm install @composio/openai
Install the Composio SDK
2

Initialize Composio and Create Tool Router Session

typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
Import and initialize Composio client, then create a Tool Router session
3

Execute Ahrefs MCP Tools via Tool Router with Your Agent

typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'YOUR_SPECIFIC_PROMPT_HERE'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
Get tools from Tool Router session and execute Ahrefs MCP actions with your Agent

Why Use Composio?

AI Native Ahrefs MCP Integration

  • Supports both Ahrefs MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Ahrefs MCP data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Ahrefs MCP access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Ahrefs MCP
  • Scoped, least privilege access to Ahrefs MCP resources
  • Full audit trail of agent actions to support review and compliance
FRAMEWORKS

Use Ahrefs MCP with any AI Agent Framework

Choose a Framework you want to connect Ahrefs MCP with

FAQ

Frequently asked questions

Yes, Ahrefs MCP requires you to configure your own Dcr Oauth credentials. Once set up, Composio handles secure credential storage and management for you.

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Start with Ahrefs MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Ahrefs MCP tool your agent needs.Free to start.

Start building