ahrefs-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| keyword-metricsB | Keyword ideas matching a seed term, with volume, difficulty, CPC, traffic potential, parent topic, and search intents. Ahrefs Keywords Explorer matching-terms. |
| keyword-suggestionsA | Real autocomplete-style search suggestions for a seed keyword, with volume, CPC, and intents. What people actually start typing into Google around the term. |
| related-keywordsA | Semantically related keywords that top-ranking pages for the seed also rank for. Surfaces adjacent on-topic terms beyond literal matches. |
| keyword-volume-historyB | Monthly search volume history for a keyword. Shows trend and seasonality. |
| keyword-volume-by-countryA | Search volume of a keyword split by country. Shows where the demand actually lives geographically. |
| serp-overviewB | Top search results for a keyword with domain rating, URL rating, traffic, page type, and result type (organic, featured snippet, AI overview, etc). |
| domain-ratingC | Domain Rating (0 to 100) and Ahrefs Rank for a domain. |
| site-metricsA | Organic profile of a domain: organic traffic, ranking keywords, top-3 keywords, traffic value, and paid traffic. Optionally scoped to one country. |
| site-metrics-historyA | Monthly organic traffic history for a domain. Shows whether a site is growing, flat, or declining. |
| site-metrics-by-countryC | Organic traffic of a domain split by country. Shows the site's real geography. |
| backlinks-statsB | Backlink footprint of a domain: live and all-time backlinks and referring domains. |
| referring-domainsA | Domains linking to a target, ordered by domain rating. Shows who links to a site and how authoritative they are. |
| organic-keywordsB | Keywords a domain ranks for, with volume, difficulty, CPC, best position, and traffic. The clonable demand behind a competitor. |
| organic-competitorsB | Domains competing with a target in organic search, with shared keywords and traffic. |
| top-pagesB | Pages that pull the most organic traffic on a domain, with top keyword and traffic value. What to study or beat first. |
| subscription-usageA | Current API units usage against the plan limit. Never cached. Check before running expensive batches. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
Most tools target distinct resources (keyword data, domain data, backlinks, SERP). Some overlap exists among keyword-related tools like keyword-metrics, keyword-suggestions, and related-keywords, but their descriptions clarify the differences. Overall, an agent can usually pick the right tool without confusion.
All tool names follow a consistent lowercase-hyphenated noun-phrase pattern (e.g., keyword-volume-history, site-metrics-by-country). No mixed conventions or verb-style changes. Names are predictable and align well with their purposes, despite 'keyword-metrics' being slightly misleading about its actual function.
16 tools is slightly above the typical 3-15 range but reasonable for a comprehensive SEO toolkit covering keyword research, domain metrics, backlinks, and SERP data. It is well-scoped for the server's purpose and does not feel bloated or redundant.
The tool set covers the core Ahrefs workflows: keyword research (volume, metrics, suggestions, related), domain organic search profiles (competitors, top pages, site metrics), backlink analysis (stats, referring domains), and SERP overviews. Minor gaps exist (e.g., no rank-tracker history or site audit data) but they are beyond the apparent scope and agents can work around them using available tools.