How to Use the Ahrefs MCP in Vercel AI SDK

Q: Can Vercel AI SDK stream Ahrefs keyword search volumes in real-time?

Yes, by passing getkeywordvolumehistory to the model inside your edge route, the historical volume data streams straight to your UI. This prevents long API response times from blocking the page render, letting your users see trends populate instantly.

Q: Does this MCP Server setup support private Ahrefs SEO dashboards on Vercel AI SDK?

Yes, you can secure your Ahrefs tools by configuring an authProvider during the createMCPClient initialization. This ensures only logged-in users on your Next.js app can trigger backlink or keyword queries.

Feed live SEO metrics straight to your Next.js frontend with Vercel AI SDK and the managed 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 Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream SERP data directly into UI components

The `get_serp_overview` tool pulls real-time search engine results pages and feeds them directly to your Vercel AI SDK streaming parser. Instead of making your users stare at a static loading spinner while fetching search metrics, this setup streams the layout of top ranking sites directly into your React components as the data arrives. By combining `get_keyword_overview` with `streamText`, your Next.js edge functions render keyword difficulty and volume metrics line-by-line. You call `mcpClient.tools()` to register the Ahrefs schema, allowing your frontend to render interactive SEO charts the millisecond the API responds.

Build instant backlink monitors with Vercel AI SDK

The `get_backlinks_stats` tool retrieves referring domains, anchor texts, and domain ratings to feed your interactive dashboard components. Your Vercel AI SDK UI displays live counters that tick upward as your React hooks process the incoming stream of link metrics. You use `list_broken_backlinks` to build a live-updating table of dead links that alerts your team immediately. The edge-compatible client processes these nodes on the fly, then runs `mcpClient.close()` to clean up resources after sending the final payload to the browser.

Feed live SEO keyword ideas to your LLM interfaces

The `list_keyword_ideas` tool generates search variations and volume trends directly within your streaming chat interface. Your Vercel AI SDK setup passes these variations to the model, which immediately outputs structured keyword recommendations into your custom UI cards. Using `list_organic_keywords` alongside this server lets you build custom competitive research tools that display ranking positions in real-time. The React frontend updates each table row dynamically, bypassing slow database writes to show users immediate organic search insights.

Setup guide

Set up Ahrefs MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Ahrefs tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Ahrefs transactions",
});

console.log(text);
await mcpClient.close();

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 Vercel AI SDK

Install the core packages via npm, then instantiate the client using `createMCPClient` with your Vinkius HTTP URL. Pass the returned tools directly into `streamText` or `generateText` to let your React components access live Ahrefs data. Remember to call `mcpClient.close()` once the generation finishes to free up active connections.

Yes, by passing `get_keyword_volume_history` to the model inside your edge route, the historical volume data streams straight to your UI. This prevents long API response times from blocking the page render, letting your users see trends populate instantly.

The SDK relies on your edge function configuration and Vinkius's managed infrastructure to queue requests. Since you get pre-authenticated endpoints, the server manages the API budget so your frontend never triggers raw rate limit blocks during peak traffic.

Yes, you can secure your Ahrefs tools by configuring an `authProvider` during the `createMCPClient` initialization. This ensures only logged-in users on your Next.js app can trigger backlink or keyword queries.

Your proprietary backlink profiles, organic keywords, and search history remain fully isolated within our V8 sandbox environment. Vinkius processes these SEO metrics using ephemeral instances that destroy themselves immediately after your Vercel AI SDK stream closes, leaving zero persistent storage traces.

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