How to connect Ahrefs MCP to Claude Cowork

Connect Claude Cowork to Ahrefs MCP. List top backlinks for example.com, compare keyword rankings for two competitors, and more using natural language, with authentication handled for you.

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

Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.

This guide walks you through the easiest and most secure way to connect your Ahrefs account to Cowork via Composio Connect, enabling it to list top backlinks for example.com, compare keyword rankings for two competitors, get organic traffic estimates by page, and more such actions on your behalf without compromising your account security.

Also integrate Ahrefs MCP with

Connecting Ahrefs to Claude Cowork

1. Open Customize

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

2. Add the Composio MCP server

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

3. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Cowork

4. Connect your Ahrefs account

Back in Cowork, ask the agent to connect to Ahrefs or give it any Ahrefs-related task.

For example, ask Cowork to:

  • "List top backlinks for example.com"
  • "Compare keyword rankings for two competitors"
  • "Get organic traffic estimates by page"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Cowork, and your Ahrefs account is ready to use.

What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.

With Composio Connect, Cowork can securely access apps like Ahrefs through MCP without you sharing account credentials directly with the agent.

What is the Ahrefs MCP server, and what's possible with it?

The Ahrefs MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Ahrefs account. It provides structured and secure access so your agent can perform Ahrefs operations on your behalf.

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.

FRAMEWORKS

How to build Ahrefs MCP Agent with another framework

FAQ

Frequently asked questions

With a standalone Ahrefs MCP server, the agents and LLMs can only access a fixed set of Ahrefs tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Ahrefs and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Ahrefs tools.

Yes, absolutely. You can configure which Ahrefs scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Ahrefs data and credentials are handled as safely as possible.

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