Ahrefs MCP

Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics. When analyzing a domain name, you must use mode=subdomains. Using mode=domain can exclude www and other subdomains. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-ai-responses-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

Provides the historical number of citations for your and competitors' brand URLs in an LLM you specify. Every entity provided in `brands` (and `competitors`, when applicable) must include at least one value in `url_groups`. Entities consisting only of `names` are not supported here because citations are matched against URL groups. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Every entity provided in `brands` (and `competitors`, when applicable) must include at least one value in `url_groups`. Entities consisting only of `names` are not supported here because citations are matched against URL groups. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-cited-domains-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-cited-pages-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

Provides the historical number of impressions for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-impressions-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

Provides the historical number of impressions for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-impressions-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

Provides the historical number of mentions for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-mentions-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

Provides the historical number of mentions for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-mentions-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

Provides the historical share of voice for your and competitors's brands in an LLM you specify. Prefer using the equivalent 'brand-radar-sov-history-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

Provides the historical share of voice for your and competitors's brands in an LLM you specify. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

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. Prefer using the equivalent 'brand-radar-sov-overview-entities' tool since the inputs are more descriptive. Use doc tool first to get the real input schema.

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. Prefer using this tool instead of the non '*-entities' tool, since you can more accurately describe brands/competitors with multiple names and/or their websites. Use doc tool first to get the real input schema.

Full documentation for Ahrefs API v3 and the corresponding MCP tools. You must use this tool to get the input schema for any other tool. The documentation is returned in OpenAPI format. It can be used to craft a request to the API v3 directly, or to the MCP server. Online documentation for the Ahrefs API v3 is also available at https://docs.ahrefs.com/docs/api/reference/introduction

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. Use doc tool first to get the real input schema.

Returns Google Search Console CTR (click-through rate) data by keyword position, showing each keyword's average position, CTR percentage, and click count. Use doc tool first to get the real input schema.

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific keywords over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.

Returns Google Search Console keywords table data with metrics (clicks, impressions, CTR, position) and associated URLs for a project. Use doc tool first to get the real input schema.

Returns Google Search Console click metrics grouped by country for a project. Use doc tool first to get the real input schema.

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific pages over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.

Returns Google Search Console pages table data with metrics (clicks, impressions, CTR, position) and associated keywords for a project. Use doc tool first to get the real input schema.

Returns Google Search Console pages chart data showing total indexed pages over time for a project. Use doc tool first to get the real input schema.

Returns Google Search Console performance metrics (clicks, impressions, CTR, position) broken down by device type (desktop, mobile, tablet) for a project. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

Returns Google Search Console performance chart data (clicks, impressions, CTR, position) for a project over time, grouped by daily, weekly, or monthly intervals. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

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. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

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. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

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. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

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. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

Retrieves search volume metrics for a specified keyword broken down by country. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

Retrieves historical search volume data for a specified keyword within a given country and date range. Requests will not consume API units if you use only "ahrefs" or "wordcount" in the `keywords` or `keyword` query parameter. Use doc tool first to get the real input schema.

Retrieves custom prompts for a specific brand radar report. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.

Retrieves the list of custom brand radar reports. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.

Retrieves keywords from a keyword list. Requests to this endpoint are free and do not consume any API units. Use doc tool first to get the real input schema.

Retrieves a list of management locations filtered by country code and optionally by US state. Use doc tool first to get the real input schema.

Retrieves the list of competitors associated with a specific Rank Tracker project in Ahrefs, using the project's unique identifier. Use doc tool first to get the real input schema.

Returns all tracked keywords for a specific Rank Tracker project, including associated tracking metadata. Use doc tool first to get the real input schema.

Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID. Use doc tool first to get the real input schema.

Returns the IP ranges used by the Ahrefs public web crawler, typically for allowlisting or firewall configuration. Use doc tool first to get the real input schema.

Returns the list of individual IP addresses currently used by the Ahrefs public web crawler. Use doc tool first to get the real input schema.

Retrieves the domain rating for a specified domain or URL as of today. Use doc tool first to get the real input schema.

Returns the top 1M domains ranked by Ahrefs Domain Rating, together with each domain's current Domain Rating. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

Provides an overview of competitor metrics for a specified project and date in Ahrefs Rank Tracker. Metrics include: share of voice, share of traffic value, average position, traffic, traffic value, and positions, and counts of SERP features. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

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. Use doc tool first to get the real input schema.

Render an interactive data table widget with sorting, search, and pagination. Accepts column definitions (key and label) and row data. Column types are inferred automatically from the data. IMPORTANT: preserve array values in row data as JSON arrays (e.g. tags: ["tag1", "tag2"]), do not flatten them to comma-separated strings. The source field is optional: set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'site-explorer-all-backlinks' not 'my-connector:site-explorer-all-backlinks'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link.

Render a scorecard widget showing key metrics as a card grid. Accepts metric cards with labels, raw numeric values, optional unit, optional change indicators, and optional grouping. IMPORTANT: 'value' is a raw number (e.g. 1234567 not '1,234,567' or '1.2M'); the frontend handles all display formatting. Use 'unit' for symbols: '$' for currency, '%' for percentages, 's' for duration in seconds (rendered as e.g. '11m 27s'). Monetary values are in USD cents (not dollars), make sure to divide them by 100 first such that they are displayed in USD. Omit 'value' or pass null for N/A. Change indicators: change.value is a positive number (the percentage amount, e.g. 12.4 for a 12.4% change); change.direction is 'up' or 'down'. When there are more than 4 cards, use the 'group' field to organize them into logical sections (e.g. 'Organic' and 'Paid'). Always include the source field when the data came from an Ahrefs tool call. Set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'site-explorer-metrics' not 'my-connector:site-explorer-metrics'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link.

Render an interactive time series line chart. Accepts one or more named data series. Supports multi-series with automatic dual Y-axis when 2 series have different units. Features hover tooltip, vertical crosshair, and toggleable legend. IMPORTANT: series names are shown in the chart legend and must be human-readable labels. Convert snake_case identifiers to Title Case (e.g. 'position_1_to_3' becomes 'Position 1 to 3', 'org_traffic' becomes 'Organic Traffic'). Expand abbreviations where possible (e.g. 'ctr' becomes 'CTR', 'org' becomes 'Organic', 'avg' becomes 'Average'). Never pass an empty string as a series name; use a descriptive label like 'Other' or 'Not Set' instead. The source field is optional: set source.tool to the bare tool name without any connector or namespace prefix (e.g. 'brand-radar-sov-history' not 'my-connector:brand-radar-sov-history'), and source.params to the arguments you passed, to generate an 'Open in Ahrefs' link. Unit labels appear next to values in tooltips: only set unit for currencies ('$') or percentages ('%'). Omit unit for all other metrics. Monetary values are in USD cents (not dollars), make sure to divide them by 100 first such that they are displayed in USD.