How to Use the Ahrefs MCP in OpenAI Agents SDK

Connect Ahrefs to the OpenAI Agents SDK to build production SEO agents with built-in guardrails.

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 OpenAI Agents SDK

Create your Vinkius account to connect Ahrefs to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Ahrefs MCP Server for production agents

Your OpenAI agent needs real SEO data to make decisions. Passing the Ahrefs MCP Server to the Agent constructor gives it immediate access to live search metrics. The SDK handles tool discovery automatically so you skip writing custom API wrappers. Build a workflow that runs `get_domain_overview` against a competitor list. If the agent spots a weakness, it fires `list_organic_keywords` to find their exact traffic sources. OpenAI's built-in guardrails validate these calls before execution, keeping your automated SEO research strictly within defined bounds.

Traceable backlink auditing

Link building requires digging through massive amounts of garbage. You can write an agent that pulls target sites using `get_backlinks_stats` and filters out low-authority domains. Every step shows up in the OpenAI dashboard tracing. When a promising prospect appears, the system runs `list_broken_backlinks` on their domain. Finding a 404 page gives your outreach team a specific angle for their pitch. The agent handles the tedious discovery phase while you monitor the exact API calls it makes.

Historical keyword analysis

Search volume changes constantly. Relying on static snapshots ruins your content strategy. Connect this tool to your specialized research agent and let it pull data via `get_keyword_volume_history` to map out seasonal trends. Handoffs between specialized agents make this powerful. One agent uses `list_keyword_ideas` to build a broad list. It passes the filtered results to a second agent that checks `get_serp_overview` to see if those terms are actually winnable.

Setup guide

Set up Ahrefs MCP in OpenAI Agents SDK

Prerequisites

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

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Ahrefs tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Ahrefs tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Ahrefs tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Ahrefs Agent",
            instructions="You have access to Ahrefs tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Instantiate MCPServerStreamableHttp with your Vinkius endpoint URL. Pass it in the mcp_servers array when you initialize your Agent. Set cacheToolsList to true to speed up subsequent runs.

Yes, the SDK enforces strict guardrails before execution. If your agent tries to send malformed parameters to get_keyword_overview, the system catches it before hitting the API.

Your agents can read domain health, backlink profiles, and keyword volumes. They access the exact same data you see in the web dashboard.

The connection uses an async context manager by default. This prevents your main application thread from blocking while waiting for large backlink reports to return.

We run this server in an ephemeral V8 Isolate Sandbox. Your search queries and competitor lists exist only for the duration of the request. Zero data persists after the connection closes.

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