How to Use the AdGuard Home MCP in Vercel AI SDK

Q: How do I handle Vercel AI SDK tool calls for AdGuard Home?

You install @ai-sdk/mcp and set up createMCPClient pointing to the Vinkius MCP Server endpoint. Pass the tools from mcpClient.tools() into your Vercel AI SDK streamText function so your agent can execute calls like getstatus on your AdGuard Home instance.

Q: Can I stream live DNS query logs from AdGuard Home using Vercel AI SDK?

Yes. Your Vercel AI SDK agent can call getquerylog to fetch recent AdGuard Home traffic data. The Vercel AI SDK streams this log data directly into your frontend components, letting you build real-time traffic monitors that update as queries hit your network.

Q: How do I close the MCP connection when using Next.js Server Actions?

Always call await mcpClient.close() after your Vercel AI SDK text generation completes. This prevents hanging TCP connections and ensures your serverless execution environment cleans up its resources properly.

Build Next.js apps that let users toggle AdGuard Home protection and view live DNS query logs via the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect AdGuard Home MCP to Vercel AI SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live Network Diagnostics in the UI

This AdGuard Home MCP Server connects your Vercel AI SDK frontend directly to your local network DNS controls. You don't want your Next.js users waiting for a full page reload to see if their AdGuard Home DNS is working. When you hook this server into your Next.js app, your Vercel AI SDK agent checks AdGuard Home network health on the fly. It queries `get_status` and `get_dns_info` to grab live AdGuard Home metrics and streams them to your Vercel AI SDK UI. The Vercel AI SDK renders these raw AdGuard Home network diagnostics as they stream in. If a domain is acting up, the Vercel AI SDK agent calls `check_host` instantly to see if an AdGuard Home blocklist is causing the issue. Your Next.js users get immediate AdGuard Home status updates without staring at a loading spinner.

Manage DNS Rewrites Live with the Vercel AI SDK

This AdGuard Home MCP Server lets you modify local DNS records directly from your Vercel AI SDK user interface. Updating AdGuard Home DNS records usually requires logging into a clunky local admin portal. This integration changes that by letting your Vercel AI SDK users ask the agent to point a local domain to a new IP inside AdGuard Home. The agent handles the request by executing `add_rewrite` directly from your Vercel Edge Functions. You can display the updated AdGuard Home list using `list_rewrites` right inside your React components. Because Vercel AI SDK handles tool outputs natively, the newly created AdGuard Home DNS mapping appears in the browser window the millisecond the server processes it.

Dynamic Client Management

This AdGuard Home MCP Server handles local network client registration directly from your Vercel AI SDK app. Adding a new device to your home network shouldn't require manual AdGuard Home configuration. Your Vercel AI SDK agent can register new hardware instantly using `add_client` and assign fixed IPs with `add_static_lease` during a chat session. The AdGuard Home client list updates dynamically in your React frontend. By calling `list_clients` or searching via `search_clients` inside your Vercel AI SDK code, you keep your custom dashboard perfectly synced with your actual AdGuard Home DHCP server state.

Setup guide

Set up AdGuard Home 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 AdGuard Home 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 AdGuard Home 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 AdGuard Home. 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 AdGuard Home 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 AdGuard Home MCP in Vercel AI SDK

You install `@ai-sdk/mcp` and set up `createMCPClient` pointing to the Vinkius MCP Server endpoint. Pass the tools from `mcpClient.tools()` into your Vercel AI SDK `streamText` function so your agent can execute calls like `get_status` on your AdGuard Home instance.

Yes. Your Vercel AI SDK agent can call `get_query_log` to fetch recent AdGuard Home traffic data. The Vercel AI SDK streams this log data directly into your frontend components, letting you build real-time traffic monitors that update as queries hit your network.

It is. The Vinkius MCP Server manages the connection securely, meaning your Vercel AI SDK Edge Functions do not need direct database access or local network exposure to run `set_protection` or modify filters on AdGuard Home.

Always call `await mcpClient.close()` after your Vercel AI SDK text generation completes. This prevents hanging TCP connections and ensures your serverless execution environment cleans up its resources properly.

The server processes your AdGuard Home DNS query logs and local IP configurations inside an isolated V8 sandbox. No network data is stored on Vinkius, and the endpoint token keeps your private network topology hidden from the public internet.

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