Docs
Search docs...⌘K

Tool Categories

Some MCP clients limit the amount of tools that an MCP server is allowed to advertise. Ahrefs' MCP server goes above this limit for many of them. We provide a way to make sure that the MCP client doesn't remove access to tools that you need.

When connecting to the MCP server, you can use a URL query parameter tools to choose which groups you'd like to have access to. Separate multiple groups with a comma:

https://api.ahrefs.com/mcp/mcp?tools=site-explorer-overview,brand-radar-entities

If you omit the tools parameter, all tools are advertised.

info

Documentation and rendering helper tools are always included, regardless of which groups you select.

Available tool groups

GroupDescription
site-explorer-overviewCore Site Explorer metrics — domain rating, backlink and outlink stats, organic/paid overview, metrics history.
site-explorer-reportsDetailed Site Explorer reports — backlinks, referring domains, anchors, organic keywords and competitors, top pages, linked domains.
keywords-explorerKeyword research — overview, volume by country and history, matching/related terms, search suggestions.
serp-overviewSERP overview for a keyword.
rank-trackerRank Tracker — overview and competitor reports.
site-auditSite Audit — projects, issues, page explorer, page content.
brand-radar-simpleBrand Radar reports (domain/URL level).
brand-radar-entitiesBrand Radar reports (entity level).
web-analytics-overviewWeb Analytics stats and charts.
web-analytics-sourcesWeb Analytics traffic sources, source channels, and referrers.
web-analytics-geoWeb Analytics geographic breakdowns — continents, countries, cities.
web-analytics-user-agentsWeb Analytics device, browser, operating system, and language breakdowns.
web-analytics-pagesWeb Analytics top pages, entry pages, and exit pages.
gscGoogle Search Console — keywords, pages, positions, and performance history.
social-mediaSocial media — channels, posts, authors, and their metrics.
batch-analysisBatch analysis of multiple targets in a single request.
managementAccount management — projects, keyword lists, locations, and Brand Radar configuration.
publicPublic/free endpoints — crawler IP ranges and free domain rating.
subscription-infoYour subscription limits and usage.

Essentials

If your client caps how many tools it accepts, use tools=essentials for a curated set of the most commonly used tools across all groups:

https://api.ahrefs.com/mcp/mcp?tools=essentials

info

essentials is a standalone value, it can't be combined with other groups. tools=essentials,site-audit is rejected; request either essentials on its own, or a comma-separated list of the groups above.

info

If you request a group name that doesn't exist, the connection is rejected with an invalid tool category error. Double-check the spelling against the table above.