Ahrefs MCP. Find out exactly why your site ranks (or doesn't).
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Ahrefs MCP delivers professional SEO intelligence directly to your AI agent. Audit backlink profiles, research keyword difficulty, and analyze domain authority instantly.
Quickly see a site's top-performing pages and track historical search volume—all from one chat window.
What your AI agents can do
Get backlinks stats
Gathers a quick summary of a website’s total backlink count and profile health.
Get domain overview
Provides core domain metrics, including Domain Rating (DR) and overall SEO health for any site.
Get keyword overview
Checks specific keywords to give you volume estimates, difficulty scores, and cost per click data.
Get a summary of backlinks, identify broken links, and list all referring domains for any site.
Retrieve current metrics like Domain Rating (DR) to track how authoritative or healthy a website is over time.
Generate new keyword ideas and check specific keywords for volume, difficulty scores, and related topics.
List the top pages a site ranks for and analyze real-time search engine results across different countries.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Ahrefs: 10 Tools for Deep SEO Analysis
Use these tools to audit everything from backlink profiles and domain authority to keyword volume and search engine results.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Ahrefs on Vinkius019d754aget backlinks stats
Gathers a quick summary of a website’s total backlink count and profile health.
019d754aget domain overview
Provides core domain metrics, including Domain Rating (DR) and overall SEO health for any site.
019d754aget keyword overview
Checks specific keywords to give you volume estimates, difficulty scores, and cost per click data.
019d754aget keyword volume history
Shows how the search volume for a keyword has changed over time in historical reports.
019d754aget serp overview
Analyzes what Google shows for a given keyword across different countries and regions.
019d754alist backlinks
Lists specific backlinks pointing to a site, allowing you to vet their quality and source.
019d754alist broken backlinks
Finds 404 errors among existing links, so you know what needs fixing on your site or client's site.
019d754alist keyword ideas
Generates a list of related and potential keywords based on a seed topic.
019d754alist organic keywords
Retrieves all the keywords a site currently ranks for, giving you an idea of its visible topics.
019d754alist top pages
Lists the most successful pages on a domain and what specific organic keywords they rank for.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Ahrefs, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Ahrefs. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The biggest time sink is checking link health.
Right now, diagnosing a site's backlink profile means jumping between dashboards. You download one report for the total links, then run another query to find broken URLs, and finally copy-paste data into a spreadsheet just to figure out which pages are actually performing well. It's slow, it’s manual, and you lose context every time you switch tabs.
With this MCP, your agent handles that entire sequence in one go. You get the full picture—the site authority from `get_domain_overview`, a clean list of all broken links via `list_broken_backlinks`, and an immediate summary of what pages are driving traffic from `list_top_pages`. The data flows directly into your chat, ready for you to act on.
Get the full scope of keyword potential with list_keyword_ideas.
Manually brainstorming content topics is exhausting. You typically start with one seed idea and then spend hours using different tools to see what's related, checking volume in a separate tab, and finally seeing which ones are low-difficulty enough to actually rank for. It’s a massive amount of copy/pasting.
Now, you simply ask the agent to run `list_keyword_ideas`. It pulls through relevant topics automatically. Then, if they look promising, you can immediately check their market viability using `get_keyword_overview`—all within minutes.
What you can do with this MCP connector
Need to audit a website's organic growth? This MCP connects your Ahrefs account directly to your AI agent, giving you access to industry-leading SEO data. You can run deep analyses on anything from backlink quality to keyword potential without leaving your workflow. For instance, start by checking a site’s overall domain health metrics and then pivot immediately to finding high-volume keywords that have low competition.
Because the power here is in combining these different types of analysis, you can chain this MCP with other services inside Vinkius to build complex automations spanning multiple platforms. You plug your token into any MCP-compatible client like Cursor or Claude, and your agent handles running the full diagnostic sequence through natural conversation.
019d754a-1625-70e3-b658-c07a7a62d730 
How Ahrefs MCP Works
- 1 Subscribe to this MCP and enter your Ahrefs API v3 Token.
- 2 Connect your AI client (like Cursor or Windsurf) to Vinkius, allowing the agent access to this data stream.
- 3 Ask your agent a question—for example, 'What is the domain overview for example.com?'—and it returns structured metrics and analysis.
The bottom line is you get deep SEO insights without having to log into multiple dashboards or manually run reports.
Who Is Ahrefs MCP For?
Anyone who relies on organic traffic for revenue. This is the content marketer frustrated by manual spreadsheet compilation, and the digital strategist who needs real-time competitor data.
Uses list_top_pages to find articles that already perform well on a site, then uses list_keyword_ideas to generate follow-up content topics.
Runs an initial audit using get_domain_overview and follows up by listing broken links with list_broken_backlinks to create a maintenance backlog.
Compares competitor authority metrics via get_backlinks_stats against their own site's performance to plan the next quarter's link building efforts.
What Changes When You Connect
- Stop guessing about a site’s authority. Use
get_domain_overviewto get the Domain Rating (DR) and see an immediate, quantifiable metric of its overall health. - Don't waste time on low-impact keywords. Run
list_keyword_ideasfirst, then check those ideas withget_keyword_overviewto prioritize targets that actually matter. - Fixing links used to mean downloading massive spreadsheets. Now, you can use
list_broken_backlinksand get an instant list of every 404 error needing attention. - Understanding traffic flow is key. By running
list_top_pages, your agent shows you which existing content is already working well, so you know where to focus your efforts next. - Compare yourself to competitors instantly. Use
get_backlinks_statsandget_keyword_overviewtogether to build a clear data gap report for management.
Real-World Use Cases
Client X needs an immediate link audit.
The strategist asks the agent to run get_domain_overview and then follow up with list_backlinks. The agent returns a full health report, showing both overall authority and specific links that need fixing.
Content team needs topic ideas.
The content manager asks the agent to find keywords related to 'remote work' using list_keyword_ideas. The agent then checks these against get_keyword_overview to filter out high-difficulty terms, giving a ready-to-write list.
The site is losing traffic and needs diagnosing.
Ask the agent to check list_top_pages for the last quarter. The resulting data shows which pages dropped off and what core keywords they used to rank for, pointing directly to content decay.
Checking a competitor's visibility.
The agent runs get_serp_overview on a target keyword for the US market. This gives granular insight into how the competition is appearing right now, allowing you to adjust your own strategy immediately.
The Tradeoffs
Focusing only on volume.
Running get_keyword_volume_history and getting a huge number. This leads the client to target massive, high-competition keywords they can't realistically rank for.
→
Don’t just look at volume. Always pair volume data with difficulty scores from get_keyword_overview first. Focus on finding the sweet spot: good volume and low competition.
Ignoring link quality issues.
Running a basic backlink count check via get_backlinks_stats and being satisfied with the number. This ignores that half those links are broken or useless, wasting time on maintenance.
→
Always run list_broken_backlinks immediately after getting the stats. Knowing exactly what's broken saves hours of manual checking.
Treating SEO as a single function.
Only analyzing links using one tool, ignoring keywords or content gaps entirely. This results in reports that only say 'your links are fine,' without actionable steps on what to write next.
→
Combine tools. Start with list_top_pages to see existing winners, then use list_keyword_ideas to expand them into new, high-potential content.
When It Fits, When It Doesn't
Use this MCP if your primary goal is a technical audit: 'How strong are we right now?' If you need to measure authority (DR), check link health (list_broken_backlinks), or pinpoint exact keywords that generate traffic, this is essential. Don't use it if your problem is pure user experience; these tools can’t tell you if your site feels slow or confusing. For content strategy gaps, don’t rely only on get_keyword_overview. Supplement that data by running a full audit using list_top_pages to ensure the keywords are actually tied to existing, high-quality content.
Common Questions About Ahrefs MCP
How do I use get_domain_overview to check a competitor? +
Just ask your agent for the domain overview and provide the competitor's URL. It will return their current Domain Rating (DR) and overall link profile health immediately.
What is the best way to find new content ideas with list_keyword_ideas? +
Use list_keyword_ideas first, then pipe those results into get_keyword_overview. This lets you filter for keywords that are both relevant and have a low difficulty score.
Can I find out if my backlinks are pointing to broken pages? Use list_broken_backlinks. +
Yes. Running list_broken_backlinks identifies every 404 error in your link structure, giving you an actionable cleanup task list for the development team.
Do I need to use get_keyword_overview before running any other keyword tool? +
It's smart practice. Use get_keyword_overview first to validate if a keyword has enough search volume and low enough difficulty score to be worth the effort.
When running get_domain_overview, how should I handle my Ahrefs API credentials? +
You must provide your active Ahrefs API v3 Token when setting up the MCP. Vinkius handles passing those keys through a zero-trust proxy; they are used only in transit and never stored on disk.
If I run get_keyword_volume_history repeatedly for different keywords, how are rate limits managed? +
The MCP monitors usage based on your API plan. If you hit a limit, the tool returns an explicit error message. Check the output logs to see if you need to pause or adjust your query volume.
When I call get_serp_overview, what specific geographic data can I analyze? +
This tool retrieves real-time search results based on the country code you specify. You get to see rankings, featured snippets, and overall result structure for any market you need.
When running list_backlinks, how is the data output structured for readability? +
The MCP formats the link data into clean, actionable tables. You'll get clear fields including the source URL, anchor text, and associated domain rating, making it easy to report on.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.