How to Use the Ahrefs MCP in Claude Code

Q: What's the command to add the Ahrefs MCP Server to Claude Code?

You connect it with a single command: claude mcp add --transport http ahrefs-mcp -- . Use claude mcp list to confirm it's connected and ready to use.

Pipe Ahrefs data into your shell scripts with Claude Code. Automate SEO checks, track keywords, and monitor domains from the terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Ahrefs MCP to Claude Code

Create your Vinkius account to connect Ahrefs to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Ahrefs with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Ahrefs MCP Server for CI/CD

Bring SEO metrics directly into your deployment pipeline. Add a script to your GitHub Actions or Jenkinsfile that has Claude Code call `get_domain_overview`. You can then write a simple condition to fail the build if your Domain Rating drops below a certain threshold. Use it for pre-flight checks before deploying. Before a merge, run a script that uses `list_broken_backlinks` on the staging URL. If it finds any new 404s, the action fails, preventing you from shipping dead links to production.

Track Keywords with Cron and Shell

Monitor your keyword performance without any fancy dashboards. Set up a simple cron job that executes a shell script with Claude Code. The script can call `get_keyword_overview` for your most important keywords and append the results to a log file. Because Claude Code outputs raw JSON, you can pipe the data anywhere. Use `jq` to parse the output, send it to a monitoring service, or insert it into a database. It's a simple, powerful way to build your own rank tracker.

Headless Competitive Analysis

Run large-scale SEO research from any server with an SSH connection. Write a shell script that reads a list of competitor domains from a text file. For each domain, have Claude Code call `list_organic_keywords` and `list_top_pages`. This is perfect for backend data gathering. You can run the script in a Docker container or a `screen` session, dumping gigabytes of raw JSON to disk for later analysis with other tools. No browser, no GUI, just pure data extraction.

Setup guide

Set up Ahrefs MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see ahrefs-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Ahrefs transactions." It will automatically discover and invoke the available Ahrefs tools.

Terminal

claude mcp add --transport http ahrefs-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Ahrefs MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "ahrefs-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Ahrefs now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Ahrefs MCP in Claude Code

First, add your Ahrefs MCP Server token as a repository secret. In your workflow YAML, use a step to run Claude Code with a command like `claude tool ahrefs-mcp.get_domain_overview domain=...`, then check the output in the next step.

Yes, that's what it's built for. Just run your command and pipe the output directly, for example: `claude tool ahrefs-mcp.list_keyword_ideas seed=... | jq '.ideas[] | .keyword'`.

You connect it with a single command: `claude mcp add --transport http ahrefs-mcp -- `. Use `claude mcp list` to confirm it's connected and ready to use.

Authentication is handled by the single endpoint token you get from Vinkius. You provide this when you add the MCP Server to Claude Code. You don't need to manage your Ahrefs API key directly.

Yes. When you make a call, it hits an ephemeral Vinkius runtime that processes your request and is then destroyed. No SERP data, keywords, or domain metrics are stored. Your private endpoint token ensures only you can access the connection.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript