# Ahrefs MCP > Ahrefs MCP connects professional SEO data directly into your AI agent. Audit domain authority, track backlink profiles, and research keywords with industry-leading metrics—all from a single chat interface. Get detailed reports on keyword difficulty, organic traffic performance, and competitor link structures instantly. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** backlink-analysis, keyword-research, serp-tracking, domain-health, organic-growth, seo-audit ## Description Stop spending hours clicking through multiple dashboards just to compile one client report. This MCP gives your agent direct access to Ahrefs' massive SEO database. You can audit everything from domain ratings and broken links to identifying exactly which pages rank for specific keywords. Your agent manages the entire organic growth strategy conversationally, retrieving crucial data points like keyword volume metrics and real-time SERP analysis without you ever needing to open a web dashboard. When you connect this MCP via Vinkius, your AI client treats Ahrefs as just another set of tools at hand. You simply ask for insights—like 'Show me the top 10 pages ranking for 'best coffee shop' in Austin'—and get structured data back immediately. ## Tools ### get_domain_overview Retrieves a summary of a domain’s current SEO metrics, including its overall rating. ### list_backlinks Lists all the websites that link back to a specified URL or domain. ### list_organic_keywords Provides a list of keywords for which a given site currently ranks in search results. ### list_broken_backlinks Identifies and lists specific backlinks that point to non-existent 404 pages. ### get_backlinks_stats Generates a high-level summary of the total number and quality of backlinks pointing to a domain. ### list_top_pages Lists the pages on a site that are currently getting the most organic traffic. ### get_keyword_overview Pulls detailed metrics for specific keywords, including volume and difficulty scores. ### list_keyword_ideas Generates a set of related keyword ideas based on a core topic to expand content coverage. ### get_keyword_volume_history Retrieves historical data showing how the search volume for a keyword has changed over time. ### get_serp_overview Analyzes what the current search results page looks like for any given keyword and location. ## Prompt Examples **Prompt:** ``` Show me the domain overview for 'ahrefs.com'. ``` **Response:** ``` I've retrieved the domain overview for ahrefs.com. The Domain Rating (DR) is 90, and it currently ranks for over 1.5 million organic keywords. Total backlinks are approximately 25 million. ``` **Prompt:** ``` List 10 backlinks for 'example.com' with the highest Domain Rating. ``` **Response:** ``` I've retrieved the top 10 backlinks for example.com. The strongest links come from high-authority domains like wikipedia.org (DR 91) and nytimes.com (DR 94). Would you like to see the anchor texts for these links? ``` **Prompt:** ``` Check keyword metrics for 'best SEO tools' in the US. ``` **Response:** ``` I've analyzed 'best SEO tools' for the US market. The monthly search volume is 12,000, with a difficulty score of 65 (Hard). The estimated CPC is $5.50. Would you like some related keyword ideas? ``` ## Capabilities ### Audit a domain’s overall health Get comprehensive metrics on a website, including its total backlinks and current authority rating. ### Analyze linking structures List all existing backlinks or specifically identify 404 broken links that need fixing on a site. ### Research keyword performance Retrieve metrics like search volume, difficulty score, and estimate the cost per click for target keywords. ### Generate content ideas Ask your agent to brainstorm related keywords based on a seed topic or existing research. ### Track search engine results Analyze live search result pages for any keyword across different countries to see how people are searching. ## Use Cases ### Need a quick client pitch deck. A marketing agency needs to prove its value. Instead of manually logging into Ahrefs, they ask their agent: 'Give me the backlink summary for ClientX.' The agent uses `get_backlinks_stats` and immediately provides a clean metric for the report. ### Content team needs evergreen topics. A content marketer wants to expand coverage around 'remote work'. They ask the agent to use `list_keyword_ideas`. The agent returns 20 related, low-difficulty keywords they can write about this week. ### Checking a competitor’s vulnerability. A strategist suspects a competitor has poor link quality. They ask the MCP to run `list_broken_backlinks` on the competitor's site, quickly identifying dozens of links that need cleanup. ### Validating content strategy targets. Before writing an article, a writer asks: 'What is the volume history for 'best project management software'?'. The agent runs `get_keyword_volume_history`, confirming if the topic is trending up or down. ## Benefits - Instantly audit domain health. Use the `get_domain_overview` tool to pull a full metric snapshot of any site's authority (DR) and total backlink count in seconds. - Fix link rot with precision. The `list_broken_backlinks` tool quickly finds all 404 errors, letting you fix dead links before they hurt your rankings. - Deep keyword insights for content planning. Run the `get_keyword_overview` to check volume and difficulty scores, or use `list_keyword_ideas` to generate dozens of new topics. - Understand your traffic sources. The `list_top_pages` tool shows you exactly which existing pages are performing best, telling you where to focus content efforts. - Competitor analysis on demand. Use the MCP to analyze search results (`get_serp_overview`) for any keyword and see what Google is currently prioritizing in different countries. ## How It Works The bottom line is that your AI client performs complex SEO analysis using Ahrefs’ deep data without requiring manual inputs or dashboard navigation. 1. Subscribe to this MCP and provide your Ahrefs API v3 Token. 2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.). 3. Ask your agent a direct question, like 'What is the backlink summary for example.com?' The agent runs the tool and sends you the data. ## Frequently Asked Questions **How do I check my domain authority using the Ahrefs MCP?** You use the `get_domain_overview` tool to retrieve your site's current Domain Rating (DR) and other core metrics. This gives you a quick, reliable snapshot of your authority. **Is the Ahrefs MCP better than just using the website directly?** Yes, because this MCP runs these complex analyses through natural language conversation. You get structured data and reports without navigating any web dashboard. **Can I use the Ahrefs MCP to find competitor links?** Absolutely. Simply ask your agent to run `list_backlinks` on a competitor's domain, and it will list who is linking back to them for analysis. **How do I use the Ahrefs MCP for content brainstorming?** You can leverage the `list_keyword_ideas` tool. Give it a topic, and your agent generates several related keywords you can target with new content pieces. **What if my site has many broken links? Which Ahrefs MCP tool should I use?** You must run the `list_broken_backlinks` tool. It specifically checks for 404 errors, giving you a clean list of dead links to fix.