How to Use the Ahrefs MCP in CrewAI

Q: How do I share the Ahrefs MCP Server across multiple CrewAI agents?

You can pass the Vinkius endpoint URL directly into the mcps array when defining your CrewAI agents. This gives every agent in your crew access to the entire suite of Ahrefs tools, allowing them to collaborate on domain and keyword tasks.

Q: Can I restrict specific CrewAI agents from using certain Ahrefs tools?

Yes, you can use the MCPServerHTTP class from crewai.mcp along with a toolfilter. This lets you restrict your content writer agent to listkeywordideas while keeping structural tools like getdomainoverview exclusive to your analyst agent.

Q: How do CrewAI agents coordinate when analyzing Ahrefs backlink data?

Agents use CrewAI's shared memory to pass results from getbacklinksstats down the chain. The research agent pulls the raw metrics, writes them to the shared context, and the writing agent reads that context to draft targeted outreach copy.

Deploy specialized agent squads to automate your SEO strategy using CrewAI and the Ahrefs MCP Server.

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 CrewAI

Create your Vinkius account to connect Ahrefs to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Coordinate specialized SEO agents in CrewAI

The `get_domain_overview` tool provides the structural baseline for your CrewAI research squad to analyze competitor performance. A dedicated research agent pulls the high-level metrics, then passes the output to an analyst agent to identify target keywords. You configure this behavior by adding the Vinkius URL directly to the `mcps` list inside your CrewAI configuration. The agents collaborate using shared memory, ensuring that the content writer agent knows exactly which domains the research agent flagged as primary competitors.

Build autonomous keyword hunters using this MCP Server

The `list_organic_keywords` tool extracts ranking keywords from competing domains to feed your CrewAI analysis loop. A specialized strategist agent compares these terms against your own site's footprint, isolating high-value gaps. The strategist agent then invokes `list_keyword_ideas` to find related search queries that your competitors missed. This entire pipeline runs autonomously, producing a prioritized editorial calendar without requiring human intervention.

Deploy a CrewAI link monitoring squad

The `list_broken_backlinks` tool scans your link profile to find lost opportunities and broken referring pages. In CrewAI, a monitoring agent continuously watches this feed, while an outreach agent automatically drafts recovery emails to the linking webmasters. By combining this with `get_backlinks_stats`, the crew prioritizes high-value links over spammy directories. This division of labor allows your agents to handle complex link reclamation campaigns at scale.

Setup guide

Set up Ahrefs MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Ahrefs tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Ahrefs Analyst",
    goal="Access and analyze Ahrefs data via MCP.",
    backstory="Expert analyst with direct Ahrefs access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Ahrefs transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Ahrefs Analyst",
        goal="Access and analyze Ahrefs data via MCP.",
        backstory="Expert analyst with direct Ahrefs access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Ahrefs transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

You can pass the Vinkius endpoint URL directly into the `mcps` array when defining your CrewAI agents. This gives every agent in your crew access to the entire suite of Ahrefs tools, allowing them to collaborate on domain and keyword tasks.

Yes, you can use the `MCPServerHTTP` class from `crewai.mcp` along with a `tool_filter`. This lets you restrict your content writer agent to `list_keyword_ideas` while keeping structural tools like `get_domain_overview` exclusive to your analyst agent.

CrewAI supports stdio, SSE, and Streamable HTTP transports. When connecting to Vinkius, the framework handles the HTTP communication automatically so your autonomous agents can query SEO metrics without manual protocol adjustments.

Agents use CrewAI's shared memory to pass results from `get_backlinks_stats` down the chain. The research agent pulls the raw metrics, writes them to the shared context, and the writing agent reads that context to draft targeted outreach copy.

Yes, your proprietary SEO metrics, target keywords, and site audit data are secure. The integration executes inside Vinkius's zero-trust V8 sandbox, ensuring that no raw data is written to disk or exposed to external networks during your CrewAI execution runs.

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