AdGuard Home MCP Server for Mastra AIGive Mastra AI instant access to 23 tools to Add Client, Add Filter Url, Add Rewrite, and more
GDPR Free for SubscribersMastra AI is a TypeScript-native agent framework built for modern web stacks. Connect AdGuard Home through Vinkius and Mastra agents discover all tools automatically. type-safe, streaming-ready, and deployable anywhere Node.js runs.
Ask AI about this MCP Server for Mastra AI
The AdGuard Home MCP Server for Mastra AI is a standout in the Developer Tools category — giving your AI agent 23 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
Geminiimport { Agent } from "@mastra/core/agent";
import { createMCPClient } from "@mastra/mcp";
import { openai } from "@ai-sdk/openai";
async function main() {
// Your Vinkius token. get it at cloud.vinkius.com
const mcpClient = await createMCPClient({
servers: {
"adguard-home": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "AdGuard Home Agent",
instructions:
"You help users interact with AdGuard Home " +
"using 23 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with AdGuard Home?"
);
console.log(result.text);
}
main();
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
About AdGuard Home MCP Server
Connect your AdGuard Home instance to any AI agent and take full control of your network-wide privacy and security through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and AdGuard Home tool infrastructure. Connect 23 tools through Vinkius and use Mastra's built-in workflow engine to chain tool calls with conditional logic, retries, and parallel execution. deployable to any Node.js host in one command.
What you can do
- Server Status — Monitor server health, active ports, protection states, and version information in real-time.
- Protection Control — Toggle global filtering, safe browsing, and parental controls on or off, with optional timed durations.
- DNS Configuration — View and update upstream DNS servers, bootstrap settings, and cache parameters (TTL, size, and optimistic caching).
- Filter Management — Add new blocklist or allowlist URLs and manage custom user-defined filtering rules.
- Client Insights — List and search for persistent or runtime clients, and configure specific security settings for individual devices.
- Host Auditing — Instantly check if a specific domain is being filtered or blocked for a particular client.
The AdGuard Home MCP Server exposes 23 tools through the Vinkius. Connect it to Mastra AI in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 23 AdGuard Home tools available for Mastra AI
When Mastra AI connects to AdGuard Home through Vinkius, your AI agent gets direct access to every tool listed below — spanning dns-filtering, ad-blocking, network-security, and more. Every call runs in a secure, isolated environment with full audit visibility. Beyond a simple connection, you get real-time monitoring of agent activity, enterprise governance, and optimized token usage.
Add client on AdGuard Home
Add a new client
Add filter url on AdGuard Home
Add a new filter URL
Add rewrite on AdGuard Home
Add a DNS rewrite
Add static lease on AdGuard Home
Add a DHCP static lease
Check host on AdGuard Home
Check if a host is filtered
Configure tls on AdGuard Home
Configure TLS settings
Get dhcp status on AdGuard Home
Get DHCP server status
Get dns info on AdGuard Home
Get DNS configuration info
Get filtering status on AdGuard Home
Get filtering status and lists
Get query log on AdGuard Home
Get DNS query log
Get query log config on AdGuard Home
Get query log configuration
Get stats on AdGuard Home
Get DNS query statistics
Get status on AdGuard Home
Get AdGuard Home server status
Get tls status on AdGuard Home
Get TLS configuration status
List blocked services on AdGuard Home
List all available blocked services
List clients on AdGuard Home
List all clients
List rewrites on AdGuard Home
List DNS rewrites
Search clients on AdGuard Home
Search for clients
Set dns config on AdGuard Home
Update DNS settings
Set protection on AdGuard Home
globally. Enable or disable protection globally
Set user rules on AdGuard Home
Set custom user filtering rules
Update blocked services on AdGuard Home
Update blocked services schedule
Update query log config on AdGuard Home
Update query log configuration
Connect AdGuard Home to Mastra AI via MCP
Follow these steps to wire AdGuard Home into Mastra AI. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
npm install @mastra/core @mastra/mcp @ai-sdk/openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.ts and run with npx tsx agent.tsExplore tools
Why Use Mastra AI with the AdGuard Home MCP Server
Mastra AI provides unique advantages when paired with AdGuard Home through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add AdGuard Home without touching business code
Built-in workflow engine chains MCP tool calls with conditional logic, retries, and parallel execution for complex automation
TypeScript-native: full type inference for every AdGuard Home tool response with IDE autocomplete and compile-time checks
One-command deployment to any Node.js host. Vercel, Railway, Fly.io, or your own infrastructure
AdGuard Home + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the AdGuard Home MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query AdGuard Home, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed AdGuard Home as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query AdGuard Home on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using AdGuard Home tools alongside other MCP servers
Example Prompts for AdGuard Home in Mastra AI
Ready-to-use prompts you can give your Mastra AI agent to start working with AdGuard Home immediately.
"What is the current status of my AdGuard Home server?"
"Disable protection for the next 10 minutes."
"Check if 'doubleclick.net' is currently being filtered for client 192.168.1.50."
Troubleshooting AdGuard Home MCP Server with Mastra AI
Common issues when connecting AdGuard Home to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpAdGuard Home + Mastra AI FAQ
Common questions about integrating AdGuard Home MCP Server with Mastra AI.
How does Mastra AI connect to MCP servers?
MCPClient with the server URL and pass it to your agent. Mastra discovers all tools and makes them available with full TypeScript types.Can Mastra agents use tools from multiple servers?
Does Mastra support workflow orchestration?
Explore More MCP Servers
View all →
Cronitor (Cron Monitoring)
44 toolsMonitor cron jobs, heartbeats, and websites. Track performance, receive alerts, and manage uptime directly from your AI agent.
Wakapi (WakaTime Alternative)
4 toolsTrack coding time, analyze productivity stats, and manage projects via Wakapi — an open-source WakaTime alternative.
Steam Platform & Hype Intelligence
11 toolsThe definitive server for Steam platform insights — track trending games, player counts, and social connections via AI.
T-Test Statistics Engine
1 toolsRun exact Student's, Welch's, and Paired t-tests local. Get CPU-guaranteed p-values instead of LLM-hallucinated guesses.