Ahrefs MCP server

Read from the package source without running it. The installed server may list more.

• add_competitors

  Add competitors to a Rank Tracker project for monitoring and comparison. This operation is free and does not consume API units.

• add_keywords

  Add keywords to a project and assign them to specific locations for tracking. This operation allows you to expand your keyword monitoring across different geographic regions.

• add_keywords_to_list

  Add one or more keywords to an existing keyword list. The keywords will be appended to the list's current contents.

• analyze_targets_batch

  Perform batch SEO analysis on multiple targets to retrieve comprehensive metrics including backlinks, keywords, traffic, and ranking data. Customize which metrics to return and how results are ordered.

• create_brand_radar_promptwrite action

  Create custom prompts for Brand Radar reports to customize monitoring and analysis. This operation is free and does not consume API units.

• create_brand_radar_reportwrite action

  Create a brand radar report that monitors brand mentions across AI-powered data sources. This operation is free and does not consume API units.

• create_projectwrite action

  Create a new project by specifying a target URL, protocol, and matching scope. The project will be assigned to the specified owner or the workspace owner by default.

• delete_brand_radar_promptswrite action

  Remove custom prompts from a Brand Radar report. This operation is free and does not consume API units.

• delete_competitorswrite action

  Remove competitors from a Rank Tracker project. This operation is free and does not consume any API units.

• delete_keyword_list_keywordswrite action

  Remove one or more keywords from an existing keyword list. Specify the keyword list by its ID and provide the keywords to be deleted.

• delete_keywordswrite action

  Remove one or more keywords from a Rank Tracker project. This operation is free and does not consume API units.

• get_backlinks_stats

  Retrieve backlink statistics for a target domain or URL on a specific date. Returns metrics about incoming links based on your specified scope and protocol.

• get_browser_chart

  Retrieve browser usage chart data for a project, showing visitor distribution across different browsers over a specified time period with configurable granularity.

• get_browser_versions_chart

  Retrieve a chart of browser version performance metrics including visitor counts and session statistics over a specified time period.

• get_continents_chart

  Retrieve web analytics chart data aggregated by continent. This endpoint is free to use and does not consume API units.

• get_countries_chart

  Retrieve web analytics chart data aggregated by country with configurable time granularity and filtering. This endpoint is free and does not consume API units.

• get_domain_metrics

  Retrieve comprehensive SEO metrics for a domain or URL, including keyword rankings, traffic estimates, and search volume data for a specified date.

• get_domain_metrics_history

  Retrieve historical performance metrics for a domain or URL over a specified date range, with options to customize time intervals, volume calculations, and protocol scope.

• get_domain_rating

  Retrieve the domain rating for a target domain or URL on a specific date. Domain rating is a metric that indicates the authority and trustworthiness of a domain.

• get_domain_rating_history

  Retrieve historical Domain Rating data for a domain or URL over a specified time period, grouped by your chosen time interval.

• get_entry_pages_chart

  Retrieve entry pages chart data for a project, showing visitor traffic patterns across specified time periods. This endpoint is free and does not consume API units.

• get_exit_pages_chart

  Retrieve exit pages chart data for a project, showing which pages visitors exit from. Supports filtering, time-based aggregation, and customizable metrics selection.

• get_keyword_metrics
• get_keyword_volume_by_country

  Retrieve search volume metrics for a keyword broken down by country. Use this to understand geographic demand patterns and identify high-opportunity markets for your target keyword.

• get_keyword_volume_history

  Retrieve historical search volume data for a keyword across a specified date range in a given country. Use this to analyze keyword popularity trends over time.

• get_language_analytics_chart

  Retrieve browser language distribution data for web analytics with support for time-series charting across different granularities. This endpoint is free to use and does not consume API units.

• get_page_content

  Retrieve page content and metadata from a Site Audit project for a specific URL. This operation consumes 50 API units per request.

• get_rank_tracker_overview

  Retrieve overview metrics for all tracked keywords in a Rank Tracker project on a specific date, with support for filtering, sorting, and device-specific rankings.

• get_refdomains_history

  Retrieve historical data on referring domains for a target domain or URL over a specified time period, with flexible grouping and protocol filtering options.

• get_referrers_chart

  Retrieve referrers chart data for web analytics, showing traffic sources over a specified time period with configurable granularity and filtering options.

• get_search_volume_history

  Retrieve historical search volume data for a domain or URL over a specified time period. Use this to analyze organic search trends and traffic patterns.

• get_serp_overview

  Retrieve the current SERP overview for a tracked keyword, including top organic positions and ranking data. This endpoint is free and does not consume API units.

• get_serp_overview_keyword

  Retrieve SERP (Search Engine Results Page) overview data for a keyword in a specified country, including top organic positions and customizable metrics.

• get_share_of_voice_overview

  Retrieve Share of Voice data for brands across specified data sources. API unit consumption depends on prompt type: custom prompts only are free, while Ahrefs prompts follow standard pricing.

• get_source_channels_chart

  Retrieve source channels chart data with visitor analytics and session metrics, aggregated at the specified time granularity.

• get_subscription_limits_and_usage

  Retrieve current workspace and API key limits and usage information. This request is free and does not consume any API units.

• get_top_pages_chart

  Retrieve a chart of your top-performing pages with visitor metrics and engagement statistics, aggregated at your specified time granularity.

• get_traffic_sources_chart

  Retrieve traffic sources chart data with visitor metrics aggregated by your specified time granularity (hourly, daily, weekly, or monthly). This endpoint is free to use and does not consume API units.

• get_url_rating_history

  Retrieve the historical URL Rating progression for a target domain or URL over a specified date range, with flexible time-based grouping options.

• get_utm_params_chart

  Retrieve UTM parameters chart data for web analytics, visualizing traffic patterns across a specified UTM dimension over time. Use this to analyze campaign performance, traffic sources, or other UTM-tracked metrics.

• get_web_analytics_chart

  Retrieve time-series chart data for web analytics metrics with configurable time granularity. Use this to visualize analytics trends across different time periods.

• get_web_analytics_cities_chart

  Retrieve cities chart data for web analytics showing visitor distribution across geographic locations. This endpoint is free to use and does not consume API units.

• list_ai_responses

  Retrieve AI-generated responses from multiple chatbot models for brand-related queries. API unit consumption depends on prompt type: custom prompts are free, while Ahrefs prompts follow standard pricing.

• list_anchor_text

  Retrieve anchor text (clickable words in hyperlinks) that point to a target domain or URL. Use this to analyze inbound link text and understand how external sites reference your target.

• list_audit_issues

  Retrieve site audit issues for a specific project. This operation costs 50 API units per request and returns issues from either a specified crawl date or the most recent available crawl.

• list_audit_pages

  Retrieve page-level metrics and SEO data from a Site Audit crawl. This endpoint costs 50 API units per request and supports filtering, sorting, and comparison against previous crawls.

• list_audit_projects

  Retrieve health scores and performance metrics for Site Audit projects. Returns data from the most recent crawl by default, or from a specified crawl date if provided.

• list_backlinks

  Retrieve all backlinks pointing to a target domain or URL, including detailed backlink profile metrics and historical data. Results can be aggregated, filtered, and sorted to analyze link quality and sources.

• list_brand_mention_history

  Retrieve historical mention data for a brand across specified AI chatbot models and date range. API consumption varies based on prompt type: custom prompts are free, while Ahrefs prompts follow standard pricing.

• list_brand_mention_impressions_history

  Retrieve historical impression data for brand mentions across AI chatbot platforms. API consumption varies based on prompt type: custom prompts are free, while Ahrefs prompts follow standard pricing.

• list_brand_mentions_overview

  Retrieve an overview of brand mentions data across specified data sources. API unit consumption depends on prompt type: custom prompts only are free, while Ahrefs prompts follow standard pricing.

• list_brand_radar_impression_overviews

  Retrieve impressions overview data for Brand Radar across specified chatbot models and data sources. API unit consumption depends on prompt type: custom prompts are free, while Ahrefs prompts follow standard pricing.

• list_brand_radar_prompts

  Retrieve the Brand Radar prompts associated with a specific report. This operation is free and does not consume any API units.

• list_brand_radar_reports

  Retrieve brand radar reports to monitor brand performance and competitive insights. This endpoint is free to use and does not consume any API units.

• list_brand_sov_history

  Retrieve historical Share of Voice data for brands across specified chatbot models and date ranges. API unit consumption depends on prompt type: custom prompts only are free, while Ahrefs prompts follow standard pricing.

• list_broken_backlinks

  Retrieve broken backlinks pointing to a target domain or URL. Returns backlinks that result in HTTP errors, with options to filter, sort, and aggregate results by domain or similarity.

• list_browser_analytics

  Retrieve browser analytics data for a project, including visitor counts, bounce rates, and session duration metrics. This endpoint is free and does not consume API units.

• list_browser_versions

  Retrieve browser version statistics and metrics for web analytics. This endpoint is free to use and does not consume API units.

• list_cited_domains

  Retrieve domains cited in AI visibility data from chatbot models and search engines. API unit consumption depends on the prompts parameter: requests using only custom prompts are free, while requests including Ahrefs prompts follow standard pricing.

• list_cited_pages

  Retrieve pages that cite your brand across specified chatbot models and AI overviews. API unit consumption depends on the prompts parameter: custom prompt data requests are free, while requests including Ahrefs prompt data incur standard API unit charges.

• list_competitor_pages

  Retrieve competitor pages data for a Rank Tracker project on a specific date, filtered by device type and customizable metrics.

• list_competitor_rankings

  Retrieve an overview of competitor rankings for your tracked keywords on a specific date. This endpoint is free and does not consume API units.

• list_competitor_stats

  Retrieve competitor performance metrics for tracked keywords on a specified date and device type. Use this to analyze how competitors rank for your target keywords and monitor their search visibility.

• list_continent_analytics

  Retrieve web analytics metrics aggregated by continent for a specified project and time period. This endpoint is free to use and does not consume API units.

• list_country_metrics

  Retrieve performance metrics broken down by country for a target domain or URL on a specific date. Useful for analyzing geographic traffic distribution and keyword performance across regions.

• list_entry_pages

  Retrieve entry pages analytics data for a project, showing which pages users first land on. Supports filtering by date range and result limits.

• list_exit_pages

  Retrieve exit pages analytics data for a project, showing which pages users exit from most frequently. Supports filtering, sorting, and date range specification.

• list_external_anchors

  Retrieve outgoing external anchor links from a target domain or URL. Results can be filtered by search scope, protocol, and custom expressions, with configurable sorting and pagination.

• list_internal_anchors

  Retrieve outgoing internal anchor links from a target domain or URL. Results can be filtered, ordered, and scoped by search mode and protocol.

• list_keyword_history

  Retrieve the historical ranking data for keywords associated with a target domain or URL across a specified date range, with options to group results by time interval and filter by protocol.

• list_keyword_list_keywords

  Retrieve all keywords from a specified keyword list. This operation is free and does not consume any API units.

• list_language_analytics

  Retrieve browser language statistics for a project, showing how visitors are distributed across different language preferences. This endpoint is free to use and does not consume API units.

• list_linked_domains

  Retrieve domains that link to your target domain or URL, with customizable filtering, sorting, and column selection for link analysis.

• list_locations

  Retrieve available locations and supported languages for a specified country. This is a free operation that does not consume API units.

• list_organic_competitors
• list_organic_keywords

  Retrieve organic keywords that drive traffic to a target domain or URL, with metrics for a specified date. Results can be filtered, sorted, and customized to show specific data columns.

• list_outlinks_stats

  Retrieve outlink statistics for a target domain or URL. This beta endpoint provides insights into outbound links, though data may not perfectly match the Ahrefs UI and accuracy improvements are ongoing.

• list_page_history

  Retrieve historical ranking data for pages from a target domain or URL over a specified time period. Results can be grouped by daily, weekly, or monthly intervals and filtered by search scope and ranking position.

• list_pages_by_backlinks

  Retrieve the best performing pages for a target domain or URL ranked by backlink count. Use this to identify which pages attract the most external links and understand your site's link profile.

• list_pages_by_internal_links

  Retrieve the best-performing pages for a target domain or URL ranked by the number of internal links pointing to them. Use this to identify which pages are most linked internally and understand your site's link structure.

• list_pages_by_traffic

  Retrieve pages grouped by traffic volume ranges for a domain or URL. Useful for identifying high-traffic pages and traffic distribution patterns across your site.

• list_paid_pages

  Retrieve paid search pages for a target domain or URL, showing which pages are generating paid search traffic on a specified date.

• list_project_competitors

  Retrieve the list of competitors tracked for a specific project. This operation is free and does not consume any API units.

• list_project_keywords

  Retrieve all keywords tracked for a specific project in Rank Tracker. This operation is free and does not consume any API units.

• list_projects

  Retrieve your projects with optional filtering by owner, access type, and keyword tracking status. This operation is free and does not consume any API units.

• list_refdomains

  Retrieve referring domains data for a target domain or URL, with filtering and sorting capabilities to analyze backlink sources.

• list_referrers

  Retrieve referrer traffic sources and their associated metrics for a project, with optional filtering, sorting, and date range selection.

• list_related_keywords

  Discover related keywords that top-ranking pages rank for or mention, including keywords they also target and topics they discuss. Use this to identify keyword opportunities and content gaps around your target search terms.

• list_source_channels

  Retrieve web analytics data grouped by source channels, including visitor counts, bounce rates, and session duration metrics. This endpoint is free and does not consume API units.

• list_top_pages

  Retrieve the top-performing pages for a domain or URL, including organic search metrics such as traffic and rankings for a specified date.

• list_top_pages_by_pageviews

  Retrieve the top-performing pages for a project ranked by pageviews and other engagement metrics. Use filtering and date range parameters to analyze specific traffic patterns and time periods.

• list_traffic_sources

  Retrieve traffic sources data for a project, showing where visitors are coming from. Results can be filtered by date range and custom criteria, with optional sorting and pagination.

• list_utm_parameters

  Retrieve UTM parameter data for web analytics, grouped by a specified UTM dimension (source, medium, campaign, term, or content) with optional filtering and time range selection.

• list_web_analytics_by_city

  Retrieve web analytics metrics aggregated by city for a specified project. This endpoint is free to use and does not consume API units.

• list_web_analytics_by_country

  Retrieve web analytics metrics aggregated by country for a specified project and time period. Results can be filtered, sorted, and paginated to analyze geographic performance data.

• list_web_analytics_stats

  Retrieve aggregated web analytics statistics for a project, with optional filtering, sorting, and date range constraints.

• search_keyword_suggestions

  Retrieve keyword search suggestions for a specified country. Returns relevant keyword variations and related search terms to help identify search opportunities in your target market.

• search_matching_keywords
• update_brand_radar_reportwrite action

  Update the configuration of a Brand Radar report, including its monitoring frequency. This operation is free and does not consume API units.

• update_project_accesswrite action

  Update the access setting for a project to control whether it is private or shared. This operation is free and does not consume any API units.

• Code scan5 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 138 days ago8/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

80/100

higher than 60% of 769 SEO servers

Tools

100

the typical SEO server has 6

Tools that change things

9%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

31

more than 95% of 405 SEO servers

Ahrefs: common questions

Is Ahrefs MCP server safe?

Mostly: it is graded B (80/100). Read the Ahrefs safety report

How do I install Ahrefs?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Ahrefs need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Ahrefs maintained?

The last commit was 176 days ago (2026-05-12). The latest release is v1.0.3.

What can I use instead of Ahrefs?

Servers from other publishers that do the same job: bisibility MCP server, Outrank MCP server and SEO Data MCP server.

How does Ahrefs compare with other SEO MCP servers?

safety score 80/100 (higher than 60% of 769 SEO servers); tools 100 (the typical SEO server has 6); tools that change things 9% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.