Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Ahrefs MCP connector

OAuth 2.1/DCRMarketingCRM & Sales

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.

NameTypeRequiredDescription
selectarrayrequiredComma-separated list of fields to include in the response.
targetsarrayrequiredNo description.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
order_byarrayoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectstringrequiredComma-separated list of fields to include in the response.
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketstringoptionalMarket or country code for brand radar data.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectarrayrequiredComma-separated list of fields to include in the response.
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketarrayoptionalMarket or country code for brand radar data.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectstringrequiredComma-separated list of fields to include in the response.
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectarrayrequiredComma-separated list of fields to include in the response.
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectstringrequiredComma-separated list of fields to include in the response.
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tracked_urlsstringoptionalNo description.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectarrayrequiredComma-separated list of fields to include in the response.
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
tracked_urlsarrayoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
brandstringrequiredYour brand domain to track (e.g. `ahrefs.com`).
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
brandsarrayoptionalArray of brand domains to track.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectstringrequiredComma-separated list of fields to include in the response.
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectarrayrequiredComma-separated list of fields to include in the response.
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
brandstringrequiredYour brand domain to track (e.g. `ahrefs.com`).
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
brandsarrayoptionalArray of brand domains to track.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectstringrequiredComma-separated list of fields to include in the response.
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
selectarrayrequiredComma-separated list of fields to include in the response.
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
data_sourcestringrequiredAI platform to pull data from (e.g. `google_ai_overview`).
brandstringoptionalYour brand domain to track (e.g. `ahrefs.com`).
competitorsstringoptionalComma-separated list of competitor domains.
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketstringoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
data_sourcearrayrequiredAI platform to pull data from (e.g. `google_ai_overview`).
brandsarrayoptionalArray of brand domains to track.
competitorsarrayoptionalComma-separated list of competitor domains.
countryarrayoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
marketarrayoptionalMarket or country code for brand radar data.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
promptsstringoptionalSearch prompt or topic to track brand mentions for.
report_idstringoptionalID of the brand radar report to query.
tags_filterobjectoptionalNo description.
whereobjectoptionalFilter 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.

NameTypeRequiredDescription
toolstringrequiredNo 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
keywordsstringoptionalComma-separated list of keywords to analyze.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
keyword_list_idintegeroptionalID of the saved keyword list to use.
keyword_listsstringoptionalNo description.
limitintegeroptionalMaximum number of results to return.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
pagesstringoptionalNo description.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
limitintegeroptionalMaximum number of results to return.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
devicestringoptionalDevice type filter: `desktop`, `mobile`, or `tablet`.
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
portfolio_idintegeroptionalNumeric ID of the Ahrefs portfolio.
project_idintegeroptionalNumeric ID of the Ahrefs project.
search_typestringoptionalGSC search type: `web`, `image`, `video`, or `news`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
selectstringrequiredComma-separated list of fields to include in the response.
keyword_list_idintegeroptionalID of the saved keyword list to use.
keywordsstringoptionalComma-separated list of keywords to analyze.
limitintegeroptionalMaximum number of results to return.
match_modestringoptionalNo description.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
termsstringoptionalNo description.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
selectstringrequiredComma-separated list of fields to include in the response.
keyword_list_idintegeroptionalID of the saved keyword list to use.
keywordsstringoptionalComma-separated list of keywords to analyze.
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
targetstringoptionalDomain, URL, or path to analyze (e.g. `ahrefs.com`).
target_modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
target_positionstringoptionalNo description.
timeoutintegeroptionalRequest timeout in seconds.
volume_monthly_date_fromstringoptionalNo description.
volume_monthly_date_tostringoptionalNo description.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
selectstringrequiredComma-separated list of fields to include in the response.
keyword_list_idintegeroptionalID of the saved keyword list to use.
keywordsstringoptionalComma-separated list of keywords to analyze.
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
keywordstringrequiredKeyword to analyze.
limitintegeroptionalMaximum number of results to return.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
keywordstringrequiredKeyword to analyze.
date_fromstringoptionalStart date for the data range (YYYY-MM-DD).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
outputstringoptionalResponse 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.

NameTypeRequiredDescription
report_idstringrequiredID of the brand radar report to query.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
keyword_list_idintegerrequiredID of the saved keyword list to use.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
country_codestringrequiredTwo-letter ISO country code.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
us_statestringoptionalNo 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
accessstringoptionalNo description.
has_keywordsbooleanoptionalNo description.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
owned_bystringoptionalNo description.
project_idintegeroptionalNumeric 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
devicestringrequiredDevice type filter: `desktop`, `mobile`, or `tablet`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
devicestringrequiredDevice type filter: `desktop`, `mobile`, or `tablet`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
target_and_tracked_competitors_onlybooleanoptionalNo description.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
devicestringrequiredDevice type filter: `desktop`, `mobile`, or `tablet`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
devicestringrequiredDevice type filter: `desktop`, `mobile`, or `tablet`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
devicestringrequiredDevice type filter: `desktop`, `mobile`, or `tablet`.
keywordstringrequiredKeyword to analyze.
project_idintegerrequiredNumeric ID of the Ahrefs project.
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
language_codestringoptionalBCP-47 language code (e.g. `en`, `fr`).
location_idintegeroptionalNumeric ID of the target location.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
top_positionsintegeroptionalNo 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.

NameTypeRequiredDescription
columnsarrayrequiredNo description.
rowsarrayrequiredNo description.
titlestringrequiredNo description.
pageSizeintegeroptionalNo description.
sourceobjectoptionalNo 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.

NameTypeRequiredDescription
cardsarrayrequiredNo description.
titlestringrequiredNo description.
sourceobjectoptionalNo 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.

NameTypeRequiredDescription
seriesarrayrequiredNo description.
titlestringrequiredNo description.
sourceobjectoptionalNo 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
keywordstringrequiredKeyword to analyze.
selectstringrequiredComma-separated list of fields to include in the response.
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
top_positionsintegeroptionalNo 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
outputstringoptionalResponse 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
selectstringrequiredComma-separated list of fields to include in the response.
target_urlstringrequiredFull URL to analyze (e.g. `https://ahrefs.com/blog/`).
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
outputstringoptionalResponse 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
filter_modestringoptionalNo description.
issue_idstringoptionalNo description.
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
selectstringoptionalComma-separated list of fields to include in the response.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringoptionalTarget date for the snapshot (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
project_idintegeroptionalNumeric ID of the Ahrefs project.
project_namestringoptionalNo description.
project_urlstringoptionalNo 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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
historystringoptionalNo description.
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
selectstringoptionalComma-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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
selectstringoptionalComma-separated list of fields to include in the response.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
selectstringoptionalComma-separated list of fields to include in the response.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
countrystringrequiredTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
page_positionsstringoptionalNo description.
protocolstringoptionalURL 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL 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.

NameTypeRequiredDescription
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
historystringoptionalNo description.
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
datestringrequiredTarget date for the snapshot (YYYY-MM-DD).
selectstringrequiredComma-separated list of fields to include in the response.
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_comparedstringoptionalComparison date for period-over-period analysis (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
timeoutintegeroptionalRequest timeout in seconds.
volume_modestringoptionalHow to calculate search volume: `monthly` or `average`.
wherestringoptionalFilter 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
countrystringoptionalTwo-letter ISO country code to filter data (e.g. `us`, `gb`, `de`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
modestringoptionalScope of analysis: `exact`, `prefix`, `domain`, or `subdomains`.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
protocolstringoptionalURL protocol to include: `http`, `https`, or `both`.
top_positionsstringoptionalNo description.
volume_modestringoptionalHow 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.

NameTypeRequiredDescription
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
targetstringrequiredDomain, URL, or path to analyze (e.g. `ahrefs.com`).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
history_groupingstringoptionalHow to group historical data: `daily`, `weekly`, or `monthly`.
outputstringoptionalResponse 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.).

NameTypeRequiredDescription
post_idintegerrequiredNo description.
outputstringoptionalResponse 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
channel_idstringrequiredNo description.
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
outputstringoptionalResponse 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
channel_idstringrequiredNo description.
date_fromstringrequiredStart date for the data range (YYYY-MM-DD).
external_post_idstringrequiredNo description.
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
outputstringoptionalResponse 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.

NameTypeRequiredDescription
statusstringrequiredStatus filter for the resource.
author_idsstringoptionalNo description.
channel_idsstringoptionalNo description.
date_fromstringoptionalStart date for the data range (YYYY-MM-DD).
date_tostringoptionalEnd date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
offsetintegeroptionalNumber of results to skip for pagination.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
order_directionstringoptionalNo description.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
search_querystringoptionalNo 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.

NameTypeRequiredDescription
outputstringoptionalResponse 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
browser_version_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
browser_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
cities_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
continents_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
countries_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
devices_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
entry_pages_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
exit_pages_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
browser_language_to_chartstringoptionalNo description.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
os_to_chartstringoptionalNo description.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
os_versions_to_chartstringoptionalNo description.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
source_referers_to_chartstringoptionalNo description.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
source_channels_to_chartstringoptionalNo description.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
sources_to_chartstringoptionalNo description.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
pages_to_chartstringoptionalNo description.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
project_idintegerrequiredNumeric ID of the Ahrefs project.
utm_paramstringrequiredUTM parameter name to group web analytics by (e.g. `utm_campaign`).
fromstringoptionalStart date for the data range (YYYY-MM-DD).
limitintegeroptionalMaximum number of results to return.
order_bystringoptionalSort order as an array of `field:asc` or `field:desc` strings.
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
wherestringoptionalFilter 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.

NameTypeRequiredDescription
granularitystringrequiredTime granularity for aggregation: `daily`, `weekly`, or `monthly`.
project_idintegerrequiredNumeric ID of the Ahrefs project.
utm_paramstringrequiredUTM parameter name to group web analytics by (e.g. `utm_campaign`).
fromstringoptionalStart date for the data range (YYYY-MM-DD).
outputstringoptionalResponse format. Use `json` (default) or `csv`.
tostringoptionalEnd date for the data range (YYYY-MM-DD).
utm_params_to_chartstringoptionalNo description.
wherestringoptionalFilter expression in Ahrefs API filter syntax.