Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Ahrefs MCP connector

OAuth 2.0 marketingsalescrm

Connect to Ahrefs MCP to access SEO data including backlinks, keyword research, site audits, rank tracking, and web analytics directly from your AI...

Ahrefs MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'ahrefsmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Ahrefs MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'ahrefsmcp_management_brand_radar_reports',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Analyze backlinks — retrieve backlink profiles, referring domains, anchors, and broken links for any URL or domain
  • Research keywords — get keyword ideas, search volume, difficulty scores, SERP overviews, and ranking history
  • Explore site data — fetch organic and paid traffic estimates, top pages, and outlinks for any domain
  • Track rankings — monitor keyword positions across countries and devices over time
  • Audit sites — run crawls to surface broken pages, redirect chains, and on-page SEO issues
  • Analyze web analytics — retrieve traffic stats, top pages, UTM breakdowns, and traffic sources for Web Analytics projects

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

ahrefsmcp_batch_analysis # Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics. 6 params

Performs a batch analysis of multiple URLs, domains, or subdomains to retrieve selected SEO, backlink, organic, and paid traffic metrics.

Name Type Required Description
select array required Comma-separated list of fields to include in the response.
targets array required No description.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
order_by array optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_brand_radar_ai_responses # Retrieve questions asked to AI assistants and the AI-generated responses that mention your brand or competitors, including cited sources and search volume estimates. 13 params

Retrieve questions asked to AI assistants and the AI-generated responses that mention your brand or competitors, including cited sources and search volume estimates.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
select string required Comma-separated list of fields to include in the response.
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market string optional Market or country code for brand radar data.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_ai_responses_entities # Retrieve questions asked to AI assistants and the AI-generated responses that mention your brand or competitors, with entity-based inputs for more precise brand matching. 14 params

Retrieve questions asked to AI assistants and the AI-generated responses that mention your brand or competitors, with entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
select array required Comma-separated list of fields to include in the response.
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market array optional Market or country code for brand radar data.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_cited_domains # Retrieve domains cited in AI-generated responses that mention your brand or competitors in a specified LLM, with response counts and estimated monthly search volume. 12 params

Retrieve domains cited in AI-generated responses that mention your brand or competitors in a specified LLM, with response counts and estimated monthly search volume.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
select string required Comma-separated list of fields to include in the response.
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_cited_domains_entities # Retrieve domains cited in AI-generated responses mentioning your brand or competitors in a specified LLM, using entity-based inputs for more precise brand matching. 13 params

Retrieve domains cited in AI-generated responses mentioning your brand or competitors in a specified LLM, using entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
select array required Comma-separated list of fields to include in the response.
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_cited_pages # Retrieve pages cited in AI-generated responses that mention your brand or competitors in a specified LLM, with response counts and estimated monthly search volume. 13 params

Retrieve pages cited in AI-generated responses that mention your brand or competitors in a specified LLM, with response counts and estimated monthly search volume.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
select string required Comma-separated list of fields to include in the response.
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tracked_urls string optional No description.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_cited_pages_entities # Retrieve pages cited in AI-generated responses mentioning your brand or competitors in a specified LLM, using entity-based inputs for more precise brand matching. 14 params

Retrieve pages cited in AI-generated responses mentioning your brand or competitors in a specified LLM, using entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
select array required Comma-separated list of fields to include in the response.
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string optional Target date for the snapshot (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
tracked_urls array optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_impressions_history # 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. 10 params

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.

Name Type Required Description
brand string required Your brand domain to track (e.g. `ahrefs.com`).
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_impressions_history_entities # Retrieve the historical number of impressions for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching. 11 params

Retrieve the historical number of impressions for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
brands array optional Array of brand domains to track.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_impressions_overview # Retrieve the number of impressions for your and competitors’ brands in a specified LLM, with filters for location, query text, URL, and more. 10 params

Retrieve the number of impressions for your and competitors’ brands in a specified LLM, with filters for location, query text, URL, and more.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
select string required Comma-separated list of fields to include in the response.
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_impressions_overview_entities # Retrieve impression counts for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL. 11 params

Retrieve impression counts for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
select array required Comma-separated list of fields to include in the response.
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_mentions_history # 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. 10 params

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.

Name Type Required Description
brand string required Your brand domain to track (e.g. `ahrefs.com`).
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_mentions_history_entities # Retrieve the historical number of mentions for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching. 11 params

Retrieve the historical number of mentions for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
brands array optional Array of brand domains to track.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_mentions_overview # Retrieve mention counts for your and competitors’ brands in a specified LLM, with filters for location, query text, URL, and more. 10 params

Retrieve mention counts for your and competitors’ brands in a specified LLM, with filters for location, query text, URL, and more.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
select string required Comma-separated list of fields to include in the response.
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_mentions_overview_entities # Retrieve mention counts for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL. 11 params

Retrieve mention counts for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
select array required Comma-separated list of fields to include in the response.
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_sov_history # 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. 11 params

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.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_sov_history_entities # Retrieve the historical share of voice for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching. 12 params

Retrieve the historical share of voice for your and competitors’ brands in a specified LLM, using entity-based inputs for more precise brand matching.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
date_from string required Start date for the data range (YYYY-MM-DD).
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. Prefer using the equivalent 'brand-radar-sov-overview-entities' tool since the inputs are more descriptive. 9 params

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.

Name Type Required Description
data_source string required AI platform to pull data from (e.g. `google_ai_overview`).
brand string optional Your brand domain to track (e.g. `ahrefs.com`).
competitors string optional Comma-separated list of competitor domains.
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market string optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_brand_radar_sov_overview_entities # Retrieve share of voice for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL. 10 params

Retrieve share of voice for your and competitors’ brands in a specified LLM, using entity-based inputs and filters for location, query text, and URL.

Name Type Required Description
data_source array required AI platform to pull data from (e.g. `google_ai_overview`).
brands array optional Array of brand domains to track.
competitors array optional Comma-separated list of competitor domains.
country array optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
market array optional Market or country code for brand radar data.
output string optional Response format. Use `json` (default) or `csv`.
prompts string optional Search prompt or topic to track brand mentions for.
report_id string optional ID of the brand radar report to query.
tags_filter object optional No description.
where object optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_doc # Retrieve full OpenAPI documentation for Ahrefs API v3 and the corresponding MCP tools. Use this tool to get the input schema for any other Ahrefs tool. 1 param

Retrieve full OpenAPI documentation for Ahrefs API v3 and the corresponding MCP tools. Use this tool to get the input schema for any other Ahrefs tool.

Name Type Required Description
tool string required No description.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_from string required Start date for the data range (YYYY-MM-DD).
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns Google Search Console CTR (click-through rate) data by keyword position, showing each keyword's average position, CTR percentage, and click count.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
ahrefsmcp_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. 10 params

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific keywords over time, grouped by daily, weekly, or monthly intervals.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
keywords string optional Comma-separated list of keywords to analyze.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_gsc_keywords # Returns Google Search Console keywords table data with metrics (clicks, impressions, CTR, position) and associated URLs for a project. 12 params

Returns Google Search Console keywords table data with metrics (clicks, impressions, CTR, position) and associated URLs for a project.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
keyword_list_id integer optional ID of the saved keyword list to use.
keyword_lists string optional No description.
limit integer optional Maximum number of results to return.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_gsc_metrics_by_country # Returns Google Search Console click metrics grouped by country for a project. 9 params

Returns Google Search Console click metrics grouped by country for a project.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 9 params

Returns Google Search Console performance history chart data (clicks, impressions, CTR, position) for specific pages over time, grouped by daily, weekly, or monthly intervals.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
pages string optional No description.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
ahrefsmcp_gsc_pages # Returns Google Search Console pages table data with metrics (clicks, impressions, CTR, position) and associated keywords for a project. 10 params

Returns Google Search Console pages table data with metrics (clicks, impressions, CTR, position) and associated keywords for a project.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
limit integer optional Maximum number of results to return.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_gsc_pages_history # Returns Google Search Console pages chart data showing total indexed pages over time for a project. 10 params

Returns Google Search Console pages chart data showing total indexed pages over time for a project.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 8 params

Returns Google Search Console performance metrics (clicks, impressions, CTR, position) broken down by device type (desktop, mobile, tablet) for a project.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 10 params

Returns Google Search Console performance chart data (clicks, impressions, CTR, position) for a project over time, grouped by daily, weekly, or monthly intervals.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 10 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
device string optional Device type filter: `desktop`, `mobile`, or `tablet`.
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
portfolio_id integer optional Numeric ID of the Ahrefs portfolio.
project_id integer optional Numeric ID of the Ahrefs project.
search_type string optional GSC search type: `web`, `image`, `video`, or `news`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_keywords_explorer_matching_terms # Retrieve keyword ideas and SEO metrics by matching input terms or phrases in a specified country, with support for filtering, sorting, and metric selection. 11 params

Retrieve keyword ideas and SEO metrics by matching input terms or phrases in a specified country, with support for filtering, sorting, and metric selection.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
select string required Comma-separated list of fields to include in the response.
keyword_list_id integer optional ID of the saved keyword list to use.
keywords string optional Comma-separated list of keywords to analyze.
limit integer optional Maximum number of results to return.
match_mode string optional No description.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
terms string optional No description.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_keywords_explorer_overview # Retrieve an overview of keyword metrics—including search volume, CPC, ranking difficulty, traffic potential, and intent—for specified keywords, domains, or URLs. 14 params

Retrieve an overview of keyword metrics—including search volume, CPC, ranking difficulty, traffic potential, and intent—for specified keywords, domains, or URLs.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
select string required Comma-separated list of fields to include in the response.
keyword_list_id integer optional ID of the saved keyword list to use.
keywords string optional Comma-separated list of keywords to analyze.
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
target string optional Domain, URL, or path to analyze (e.g. `ahrefs.com`).
target_mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
target_position string optional No description.
timeout integer optional Request timeout in seconds.
volume_monthly_date_from string optional No description.
volume_monthly_date_to string optional No description.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_keywords_explorer_search_suggestions # Retrieve keyword search suggestions and metrics such as search volume, difficulty, and CPC for specified queries, with filtering and sorting options. 9 params

Retrieve keyword search suggestions and metrics such as search volume, difficulty, and CPC for specified queries, with filtering and sorting options.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
select string required Comma-separated list of fields to include in the response.
keyword_list_id integer optional ID of the saved keyword list to use.
keywords string optional Comma-separated list of keywords to analyze.
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_keywords_explorer_volume_by_country # 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. 3 params

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.

Name Type Required Description
keyword string required Keyword to analyze.
limit integer optional Maximum number of results to return.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_keywords_explorer_volume_history # 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. 5 params

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.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
keyword string required Keyword to analyze.
date_from string optional Start date for the data range (YYYY-MM-DD).
date_to string optional End date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_brand_radar_prompts # Retrieves custom prompts for a specific brand radar report. Requests to this endpoint are free and do not consume any API units. 2 params

Retrieves custom prompts for a specific brand radar report. Requests to this endpoint are free and do not consume any API units.

Name Type Required Description
report_id string required ID of the brand radar report to query.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_brand_radar_reports # Retrieves the list of custom brand radar reports. Requests to this endpoint are free and do not consume any API units. 1 param

Retrieves the list of custom brand radar reports. Requests to this endpoint are free and do not consume any API units.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_keyword_list_keywords # Retrieves keywords from a keyword list. Requests to this endpoint are free and do not consume any API units. 2 params

Retrieves keywords from a keyword list. Requests to this endpoint are free and do not consume any API units.

Name Type Required Description
keyword_list_id integer required ID of the saved keyword list to use.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_locations # Retrieves a list of management locations filtered by country code and optionally by US state. 3 params

Retrieves a list of management locations filtered by country code and optionally by US state.

Name Type Required Description
country_code string required Two-letter ISO country code.
output string optional Response format. Use `json` (default) or `csv`.
us_state string optional No description.
ahrefsmcp_management_project_competitors # Retrieves the list of competitors associated with a specific Rank Tracker project in Ahrefs, using the project's unique identifier. 2 params

Retrieves the list of competitors associated with a specific Rank Tracker project in Ahrefs, using the project's unique identifier.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_project_keywords # Returns all tracked keywords for a specific Rank Tracker project, including associated tracking metadata. 2 params

Returns all tracked keywords for a specific Rank Tracker project, including associated tracking metadata.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_management_projects # Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID. 5 params

Retrieves information about existing projects, including ownership, access type, presence of Rank Tracker keywords, and project ID.

Name Type Required Description
access string optional No description.
has_keywords boolean optional No description.
output string optional Response format. Use `json` (default) or `csv`.
owned_by string optional No description.
project_id integer optional Numeric ID of the Ahrefs project.
ahrefsmcp_public_crawler_ip_ranges # Returns the IP ranges used by the Ahrefs public web crawler, typically for allowlisting or firewall configuration. 1 param

Returns the IP ranges used by the Ahrefs public web crawler, typically for allowlisting or firewall configuration.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_public_crawler_ips # Returns the list of individual IP addresses currently used by the Ahrefs public web crawler. 1 param

Returns the list of individual IP addresses currently used by the Ahrefs public web crawler.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_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. 11 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
device string required Device type filter: `desktop`, `mobile`, or `tablet`.
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 12 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
device string required Device type filter: `desktop`, `mobile`, or `tablet`.
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
target_and_tracked_competitors_only boolean optional No description.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_rank_tracker_competitors_stats # 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. 6 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
device string required Device type filter: `desktop`, `mobile`, or `tablet`.
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
output string optional Response format. Use `json` (default) or `csv`.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_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. 11 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
device string required Device type filter: `desktop`, `mobile`, or `tablet`.
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
device string required Device type filter: `desktop`, `mobile`, or `tablet`.
keyword string required Keyword to analyze.
project_id integer required Numeric ID of the Ahrefs project.
date string optional Target date for the snapshot (YYYY-MM-DD).
language_code string optional BCP-47 language code (e.g. `en`, `fr`).
location_id integer optional Numeric ID of the target location.
output string optional Response format. Use `json` (default) or `csv`.
top_positions integer optional No description.
ahrefsmcp_render_data_table # Render an interactive data table widget with sorting, search, and pagination. Accepts column definitions and row data; column types are inferred automatically. 5 params

Render an interactive data table widget with sorting, search, and pagination. Accepts column definitions and row data; column types are inferred automatically.

Name Type Required Description
columns array required No description.
rows array required No description.
title string required No description.
pageSize integer optional No description.
source object optional No description.
ahrefsmcp_render_scorecard # Render a scorecard widget showing key metrics as a card grid. Accepts metric cards with labels, numeric values, optional units, change indicators, and groupings. 3 params

Render a scorecard widget showing key metrics as a card grid. Accepts metric cards with labels, numeric values, optional units, change indicators, and groupings.

Name Type Required Description
cards array required No description.
title string required No description.
source object optional No description.
ahrefsmcp_render_time_series_chart # Render an interactive time series line chart for one or more named data series. Supports dual Y-axis, hover tooltips, crosshair, and a toggleable legend. 3 params

Render an interactive time series line chart for one or more named data series. Supports dual Y-axis, hover tooltips, crosshair, and a toggleable legend.

Name Type Required Description
series array required No description.
title string required No description.
source object optional No description.
ahrefsmcp_serp_overview # Retrieve an overview of the top search results for a specified keyword and country, including position, backlinks, traffic, domain rating, and related keywords. 6 params

Retrieve an overview of the top search results for a specified keyword and country, including position, backlinks, traffic, domain rating, and related keywords.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
keyword string required Keyword to analyze.
select string required Comma-separated list of fields to include in the response.
date string optional Target date for the snapshot (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
top_positions integer optional No description.
ahrefsmcp_site_audit_issues # Returns all issues from your Site Audit crawl. By default, it provides data from the latest available crawl, but you can also specify a crawl date and time to retrieve historical metrics. 4 params

Returns all issues from your Site Audit crawl. By default, it provides data from the latest available crawl, but you can also specify a crawl date and time to retrieve historical metrics.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
date string optional Target date for the snapshot (YYYY-MM-DD).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_site_audit_page_content # Returns the HTML and extracted text content of a page from your Site Audit crawl. By default, it provides the latest available snapshot, but you can also specify a crawl date and time to retrieve historical snapshots. 5 params

Returns the HTML and extracted text content of a page from your Site Audit crawl. By default, it provides the latest available snapshot, but you can also specify a crawl date and time to retrieve historical snapshots.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
select string required Comma-separated list of fields to include in the response.
target_url string required Full URL to analyze (e.g. `https://ahrefs.com/blog/`).
date string optional Target date for the snapshot (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_site_audit_page_explorer # Returns detailed information about pages discovered in a Site Audit project, including URLs, crawl metadata, and selected on-page metrics. 11 params

Returns detailed information about pages discovered in a Site Audit project, including URLs, crawl metadata, and selected on-page metrics.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
date string optional Target date for the snapshot (YYYY-MM-DD).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
filter_mode string optional No description.
issue_id string optional No description.
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
select string optional Comma-separated list of fields to include in the response.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 5 params

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.

Name Type Required Description
date string optional Target date for the snapshot (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
project_id integer optional Numeric ID of the Ahrefs project.
project_name string optional No description.
project_url string optional No description.
ahrefsmcp_site_explorer_anchors # Retrieves anchor text and associated backlink metrics for a specified domain or URL, with filtering and selection options. 10 params

Retrieves anchor text and associated backlink metrics for a specified domain or URL, with filtering and selection options.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
history string optional No description.
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_site_explorer_crawled_pages # Returns a list of pages crawled by Ahrefs for a specified domain or URL, including the page URLs. 8 params

Returns a list of pages crawled by Ahrefs for a specified domain or URL, including the page URLs.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_site_explorer_domain_rating # Retrieve the domain rating and related metrics for a specified domain or URL as of a specific date. 4 params

Retrieve the domain rating and related metrics for a specified domain or URL as of a specific date.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
ahrefsmcp_site_explorer_domain_rating_history # Retrieve historical domain rating data for a specified domain or URL over a defined date range and grouping interval. 5 params

Retrieve historical domain rating data for a specified domain or URL over a defined date range and grouping interval.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
select string optional Comma-separated list of fields to include in the response.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 9 params

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.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_site_explorer_metrics_by_country # Provides organic and paid search performance metrics for a specified website, broken down by country, for a specific date. 7 params

Provides organic and paid search performance metrics for a specified website, broken down by country, for a specific date.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
select string optional Comma-separated list of fields to include in the response.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_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. 10 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
select string optional Comma-separated list of fields to include in the response.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_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. 13 params

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.

Name Type Required Description
country string required Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date string required Target date for the snapshot (YYYY-MM-DD).
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 13 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 6 params

Returns the distribution of pages by estimated organic traffic buckets for a specified domain or URL, across all locations or for a specified country.

Name Type Required Description
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_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. 9 params

Retrieves historical data about pages from a specified domain, URL, or section of a site, grouped by a chosen time interval.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
page_positions string optional No description.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
ahrefsmcp_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. 13 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
ahrefsmcp_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. 10 params

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.

Name Type Required Description
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
history string optional No description.
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 13 params

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.

Name Type Required Description
date string required Target date for the snapshot (YYYY-MM-DD).
select string required Comma-separated list of fields to include in the response.
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_compared string optional Comparison date for period-over-period analysis (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
timeout integer optional Request timeout in seconds.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 10 params

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.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
country string optional Two-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
mode string optional Scope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
output string optional Response format. Use `json` (default) or `csv`.
protocol string optional URL protocol to include: `http`, `https`, or `both`.
top_positions string optional No description.
volume_mode string optional How to calculate search volume: `monthly` or `average`.
ahrefsmcp_site_explorer_url_rating_history # Retrieve historical URL rating data for a specified domain or URL over a defined date range, grouped by a chosen time interval. 5 params

Retrieve historical URL rating data for a specified domain or URL over a defined date range, grouped by a chosen time interval.

Name Type Required Description
date_from string required Start date for the data range (YYYY-MM-DD).
target string required Domain, URL, or path to analyze (e.g. `ahrefs.com`).
date_to string optional End date for the data range (YYYY-MM-DD).
history_grouping string optional How to group historical data: `daily`, `weekly`, or `monthly`.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_activity_history # Get the activity history log for posts (published, scheduled, failed, etc.). 2 params

Get the activity history log for posts (published, scheduled, failed, etc.).

Name Type Required Description
post_id integer required No description.
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_authors # List users who have created posts in the account. 1 param

List users who have created posts in the account.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_channel_metrics # Get historical follower count data for connected channels. 4 params

Get historical follower count data for connected channels.

Name Type Required Description
channel_id string required No description.
date_from string required Start date for the data range (YYYY-MM-DD).
date_to string optional End date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_channels # List social media channels with their connection status and metadata. 1 param

List social media channels with their connection status and metadata.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_post_metrics # Get engagement metrics (views, likes, etc.) for a specific post. 5 params

Get engagement metrics (views, likes, etc.) for a specific post.

Name Type Required Description
channel_id string required No description.
date_from string required Start date for the data range (YYYY-MM-DD).
external_post_id string required No description.
date_to string optional End date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_social_media_posts # List social media posts with filtering by channel, status, and author. 11 params

List social media posts with filtering by channel, status, and author.

Name Type Required Description
status string required Status filter for the resource.
author_ids string optional No description.
channel_ids string optional No description.
date_from string optional Start date for the data range (YYYY-MM-DD).
date_to string optional End date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
offset integer optional Number of results to skip for pagination.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
order_direction string optional No description.
output string optional Response format. Use `json` (default) or `csv`.
search_query string optional No description.
ahrefsmcp_subscription_info_limits_and_usage # Retrieves subscription information including limits and usage statistics for API units, workspace quotas, and API key details. This endpoint is free and does not consume any API units. 1 param

Retrieves subscription information including limits and usage statistics for API units, workspace quotas, and API key details. This endpoint is free and does not consume any API units.

Name Type Required Description
output string optional Response format. Use `json` (default) or `csv`.
ahrefsmcp_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. 7 params

Returns browser version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser version.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by browser version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
browser_version_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_browsers # Returns browser statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser. 7 params

Returns browser statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by browser.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by browser for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
browser_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 6 params

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.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_cities # Returns visitor data grouped by city for a Web Analytics project, showing visitor counts for each location. 7 params

Returns visitor data grouped by city for a Web Analytics project, showing visitor counts for each location.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by city for a Web Analytics project, showing visitor counts over time for each location.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
cities_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_continents # Returns visitor data grouped by continent for a Web Analytics project, showing visitor counts for each region. 7 params

Returns visitor data grouped by continent for a Web Analytics project, showing visitor counts for each region.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by continent for a Web Analytics project, showing visitor counts over time for each region.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
continents_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_countries # Returns visitor data grouped by country for a Web Analytics project, showing visitor counts for each location. 7 params

Returns visitor data grouped by country for a Web Analytics project, showing visitor counts for each location.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by country for a Web Analytics project, showing visitor counts over time for each location.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
countries_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_devices # Returns device type statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by device type. 7 params

Returns device type statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by device type.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by device type for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
devices_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns entry page statistics for a Web Analytics project, showing which pages visitors land on first, including visitor counts and entry rates.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data for entry pages of a Web Analytics project, showing visitor counts and entry rates over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
entry_pages_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns exit page statistics for a Web Analytics project, showing which pages visitors leave from, including visitor counts and exit rates.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data for exit pages of a Web Analytics project, showing visitor counts and exit rates over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
exit_pages_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_languages # Returns visitor data grouped by browser language for a Web Analytics project, showing visitor counts for each language. 7 params

Returns visitor data grouped by browser language for a Web Analytics project, showing visitor counts for each language.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by browser language for a Web Analytics project, showing visitor counts over time for each language.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
browser_language_to_chart string optional No description.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_operating_systems # Returns operating system statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS. 7 params

Returns operating system statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by operating system for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
os_to_chart string optional No description.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns OS version statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by OS version.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by OS version for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
os_versions_to_chart string optional No description.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_referrers # Returns referrer statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referrer URL. 7 params

Returns referrer statistics for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referrer URL.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns time-series chart data grouped by referrer for a Web Analytics project, showing visitor counts, bounce rates, and session durations over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
source_referers_to_chart string optional No description.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_source_channels # Returns traffic grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, including visitor counts, bounce rates, and session durations. 7 params

Returns traffic grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, including visitor counts, bounce rates, and session durations.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_source_channels_chart # Returns time-series chart data grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, showing metrics over time. 7 params

Returns time-series chart data grouped by source channel (e.g., organic, paid, social, direct) for a Web Analytics project, showing metrics over time.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
source_channels_to_chart string optional No description.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_sources # Returns traffic source breakdown for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referral source. 7 params

Returns traffic source breakdown for a Web Analytics project, showing visitor counts, bounce rates, and session durations grouped by referral source.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

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.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
sources_to_chart string optional No description.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_web_analytics_stats # Returns aggregate statistics for a Web Analytics project, including total visitors, bounce rate, and average session duration without any dimension grouping. 7 params

Returns aggregate statistics for a Web Analytics project, including total visitors, bounce rate, and average session duration without any dimension grouping.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

Returns the most visited pages for a Web Analytics project, including pageview counts, visitor counts, bounce rates, and average page visit durations.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 7 params

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.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
pages_to_chart string optional No description.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 8 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.

Name Type Required Description
project_id integer required Numeric ID of the Ahrefs project.
utm_param string required UTM parameter name to group web analytics by (e.g. `utm_campaign`).
from string optional Start date for the data range (YYYY-MM-DD).
limit integer optional Maximum number of results to return.
order_by string optional Sort order as an array of `field:asc` or `field:desc` strings.
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
where string optional Filter expression in Ahrefs API filter syntax.
ahrefsmcp_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. 8 params

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.

Name Type Required Description
granularity string required Time granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_id integer required Numeric ID of the Ahrefs project.
utm_param string required UTM parameter name to group web analytics by (e.g. `utm_campaign`).
from string optional Start date for the data range (YYYY-MM-DD).
output string optional Response format. Use `json` (default) or `csv`.
to string optional End date for the data range (YYYY-MM-DD).
utm_params_to_chart string optional No description.
where string optional Filter expression in Ahrefs API filter syntax.