Verified OfficialVendor MaintainedHosted on ahrefs.com
Ahrefs Official MCP Server
Install NowAhrefs is an SEO platform for website analysis and keyword research
What is Ahrefs?
Ahrefs is a search and discovery platform that ahrefs is an seo comprehensive platform for website analysis and keyword research. The official Ahrefs MCP server enables AI agents to seamlessly interact with Ahrefs's platform, allowing developers to leverage AI capabilities within their existing workflows and automate complex tasks that would otherwise require manual intervention.
This official MCP server is maintained and verified by Ahrefs, ensuring reliability, security, and up-to-date functionality. Unlike community-maintained servers, this official integration provides long-term support, comprehensive documentation, and direct vendor assistance. The server is hosted on ahrefs.com, guaranteeing secure and reliable access to Ahrefs's services.
Whether you're building AI-powered applications, automating workflows, or enhancing your development tools, the Ahrefs MCP server provides a standardized way to connect AI agents with Ahrefs's extensive platform capabilities. This integration enables natural language interactions with Ahrefs, making it easier than ever to leverage Ahrefs's features through AI assistants like Claude, ChatGPT, and Cursor.
Installation Instructions
Installation Instructions
Add Ahrefs to your MCP-compatible client
https://api.ahrefs.com/mcp/mcp1
Go to Settings → Cursor Settings
2
Click "Add new global MCP Server"
3
Paste the MCP configuration into mcp.json and restart
Or manually add to your mcp.json:
{
"mcpServers": {
"ahrefs": {
"url": "https://api.ahrefs.com/mcp/mcp"
}
}
}Ahrefs MCP Server Capabilities
The official Ahrefs MCP server enables AI agents to:
- Perform real-time web searches and information retrieval
- Extract and summarize content from search results
- Access up-to-date information from the web
- Filter and rank search results intelligently
- Combine multiple search sources for comprehensive answers
These capabilities make it easy for AI agents to work with Ahrefs as part of a larger automation strategy, enabling seamless integration between AI assistants and your existing tools.
Available Tools
The Ahrefs MCP server provides 42 tools for AI agents to interact with the platform. Use the search below to find specific tools.
| Tool Name | Description |
|---|---|
batch-analysis-batch-analysis | Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics. |
doc | Full documentation for Ahrefs tools. You must use this tool to get the input schema for any other tool. |
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.g., search volume, difficulty, CPC) for specified queries or keyword lists, with options to filter, sort, and customize returned fields by country. |
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-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 | Retrieves keywords associated with a specific project in Ahrefs' Rank Tracker by project ID. |
management-projects | Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID. |
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-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. |
serp-overview-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-projects | Retrieves a list of site audit projects available in the system. |
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-best-by-external-links | 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-best-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-broken-backlinks | Retrieves a list of broken backlinks (i.e., links pointing to non-functioning pages) for a specified domain or URL, with customizable filtering, field selection, and aggregation options. |
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-linkeddomains | 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-traffic | Retrieves pages from a specified domain, subdomain, path, or exact URL, ranked by their estimated organic search traffic for a selected country and protocol. |
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 | 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-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-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 | Retrieves the historical total organic search volume, traffic, and traffic value for a given site or URL over a specified time period and grouping. |
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. |
Last updated: January 27, 2026 at 01:00 PM
Common Use Cases
Automated Workflow Management
AI agents can use the Ahrefs MCP server to automate repetitive tasks and manage workflows within Ahrefs's platform.
Data Retrieval and Analysis
The MCP server allows AI agents to query and retrieve data from Ahrefs, enabling intelligent data analysis and insights.
Integration with Development Tools
Developers can integrate Ahrefs capabilities directly into their AI coding assistants for seamless workflows.
Frequently Asked Questions
How do I get a Ahrefs API key?
Visit https://ahrefs.com, create an account, and generate an API key from your dashboard. Most tools offer a free tier to get started, making it easy to begin using the Ahrefs MCP server.
Is this the official Ahrefs MCP server?
Yes, this MCP server is officially provided and maintained by Ahrefs. The endpoint https://api.ahrefs.com/mcp/mcp is hosted on their official domain ahrefs.com, ensuring reliability and security.
What permissions does Ahrefs MCP need?
The Ahrefs MCP server requires appropriate API credentials and permissions based on the operations you want to perform. Check the documentation for specific permission requirements.
Can I use Ahrefs MCP with multiple clients?
Yes, you can configure the same MCP server across Cursor, Claude Desktop, Cline, and other MCP-compatible clients simultaneously. Each client maintains its own configuration.
Is Ahrefs MCP server free?
The MCP server itself is free to use, but you may need a Ahrefs account and API access, which may have its own pricing tiers. Check https://ahrefs.com for current pricing information.
What can Ahrefs MCP server do?
The Ahrefs MCP server enables AI agents to search the web and retrieve information. Ahrefs is an SEO platform for website analysis and keyword research This allows you to interact with Ahrefs's platform through natural language commands in your AI assistant.
Troubleshooting
Connection Failed
Ensure your API key is correctly configured and your network allows outbound connections to ahrefs.com. Verify that the MCP endpoint URL https://api.ahrefs.com/mcp/mcp is accessible from your network.
Authentication Error
Verify your API key is valid and has not expired. Generate a new key from https://ahrefs.com if needed. Make sure you're using the correct authentication method as specified in the documentation.
Server Not Responding
Check Ahrefs's status page for any ongoing incidents. Try restarting your MCP client and verify that the server endpoint is correct. If issues persist, consult the official documentation or support channels.
Related MCP Servers
Explore other official MCP servers that work well with Ahrefs:
Search and explore Hugging Face Hub resources including models, datasets, Spaces, and papers
TwelveLabs MCP: video indexing, search, analysis, and embeddings for AI applications
Access Morningstar data, research, and capabilities through specialized MCP tools for global securities
About Model Context Protocol
The Model Context Protocol (MCP) is an open standard that enables AI models to securely connect to external APIs, tools, and data sources. This official MCP server from Ahrefs provides standardized access to their services, allowing AI agents to interact with Ahrefs's platform seamlessly.
To manage all your MCP servers in one place, use Apigene's MCP Gateway, which provides centralized management, security, and governance for all your MCP server connections.
Learn more about MCP in our complete guide or browse our FAQ for common questions.
Server Information
Quick Actions