How to connect Ahrefs MCP with ChatGPT Work

Connect ChatGPT Work 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

How to connect Ahrefs MCP with ChatGPT Work

ChatGPT Work is an agent inside ChatGPT built for your most ambitious work. It takes action across your apps and files, stays with a project for hours, and turns a goal into finished materials like sheets, slides, and docs - not just answers.

In this guide, I will explain the easiest and most secure way to connect your Ahrefs account to ChatGPT Work via Composio Connect, so it can analyze backlinks, track keyword rankings, research competitors, fetch organic traffic metrics, and suggest SEO improvements through natural language commands without ever putting your account credentials at risk.

Also integrate Ahrefs MCP with

Why use Composio over default connectors?

  • Apps with read and write access. Default connectors mostly can read your data. Composio's Ahrefs integration lets ChatGPT Work take actions like creating drafts, sending updates, labeling records, and more.
  • 1,000+ SaaS toolkits out of the box. Composio gives you instant access to a vast catalog of pre-built connectors, from Gmail and Slack to Notion, Linear, and Salesforce.
  • One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
  • Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand.
  • Cross-app automation. Chain actions across multiple apps in a single run - fetch a thread, summarize it in Notion, and post highlights to Slack without leaving the conversation.

Prerequisites

  • A ChatGPT account with access to ChatGPT Work (rolling out across Pro, Enterprise, Edu, Plus, and Business plans). We will use the ChatGPT desktop app, which is available on every plan.
  • Access to the Ahrefs workspace you want to connect.
  • Composio MCP.

Note: Composio connects through OAuth. You will be asked to sign in and approve specific permissions. Review the permission screen carefully if you are using a work account.

Step-by-step: Connect Ahrefs to ChatGPT Work

1. Open the MCP settings

In ChatGPT Work, go to Settings and open the Plugins section. Inside the Plugins page, click the MCP tab.

ChatGPT Work settings showing the Plugins page with the MCP tab selected

2. Add the server

Click Add server. In the Name field enter Composio, for Type select Streamable HTTP, and in the URL field paste the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
ChatGPT Work Add server dialog with the name Composio, type Streamable HTTP, and the Composio MCP URL

Then click Save. The Composio server now appears in your MCP plugins list.

ChatGPT Work Plugins page showing the Composio MCP server added to the list

3. Authenticate

Click Authenticate, log in via Composio, and click Allow access to authorize ChatGPT Work to use your Composio account.

Composio login and Allow access screen for ChatGPT Work MCP setup

4. Start using Composio

That is it - Composio tools are now available in ChatGPT Work. Ask it to work with your Ahrefs account and it will run the actions you authorize.

What you can do after connecting Ahrefs

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

Security + privacy notes (important)

  • Use least-privilege access: Only grant permissions you actually need.
  • Review OAuth permissions before approving: Make sure requested scopes match what you expect Composio and ChatGPT Work to do.
  • Keep write actions human-reviewed: For actions like sending messages, creating labels, or editing drafts, keep manual confirmation enabled.
  • Be careful with sensitive data: Avoid using this setup with highly sensitive information unless allowed by your personal, company, or client policies.
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. ChatGPT Work 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