AdGuard Home MCP Server for LlamaIndexGive LlamaIndex instant access to 23 tools to Add Client, Add Filter Url, Add Rewrite, and more
GDPR Free for SubscribersLlamaIndex specializes in data-aware AI agents that connect LLMs to structured and unstructured sources. Add AdGuard Home as an MCP tool provider through Vinkius and your agents can query, analyze, and act on live data alongside your existing indexes.
Ask AI about this MCP Server for LlamaIndex
The AdGuard Home MCP Server for LlamaIndex 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 asyncio
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec
from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
mcp_client = BasicMCPClient("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
mcp_tool_spec = McpToolSpec(client=mcp_client)
tools = await mcp_tool_spec.to_tool_list_async()
agent = FunctionAgent(
tools=tools,
llm=OpenAI(model="gpt-4o"),
system_prompt=(
"You are an assistant with access to AdGuard Home. "
"You have 23 tools available."
),
)
response = await agent.run(
"What tools are available in AdGuard Home?"
)
print(response)
asyncio.run(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.
LlamaIndex agents combine AdGuard Home tool responses with indexed documents for comprehensive, grounded answers. Connect 23 tools through Vinkius and query live data alongside vector stores and SQL databases in a single turn. ideal for hybrid search, data enrichment, and analytical workflows.
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 LlamaIndex 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 LlamaIndex
When LlamaIndex 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 LlamaIndex via MCP
Follow these steps to wire AdGuard Home into LlamaIndex. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install dependencies
pip install llama-index-tools-mcp llama-index-llms-openaiReplace the token
[YOUR_TOKEN_HERE] with your Vinkius tokenRun the agent
agent.py and run: python agent.pyExplore tools
Why Use LlamaIndex with the AdGuard Home MCP Server
LlamaIndex provides unique advantages when paired with AdGuard Home through the Model Context Protocol.
Data-first architecture: LlamaIndex agents combine AdGuard Home tool responses with indexed documents for comprehensive, grounded answers
Query pipeline framework lets you chain AdGuard Home tool calls with transformations, filters, and re-rankers in a typed pipeline
Multi-source reasoning: agents can query AdGuard Home, a vector store, and a SQL database in a single turn and synthesize results
Observability integrations show exactly what AdGuard Home tools were called, what data was returned, and how it influenced the final answer
AdGuard Home + LlamaIndex Use Cases
Practical scenarios where LlamaIndex combined with the AdGuard Home MCP Server delivers measurable value.
Hybrid search: combine AdGuard Home real-time data with embedded document indexes for answers that are both current and comprehensive
Data enrichment: query AdGuard Home to augment indexed data with live information before generating user-facing responses
Knowledge base agents: build agents that maintain and update knowledge bases by periodically querying AdGuard Home for fresh data
Analytical workflows: chain AdGuard Home queries with LlamaIndex's data connectors to build multi-source analytical reports
Example Prompts for AdGuard Home in LlamaIndex
Ready-to-use prompts you can give your LlamaIndex 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 LlamaIndex
Common issues when connecting AdGuard Home to LlamaIndex through Vinkius, and how to resolve them.
BasicMCPClient not found
pip install llama-index-tools-mcpAdGuard Home + LlamaIndex FAQ
Common questions about integrating AdGuard Home MCP Server with LlamaIndex.
How does LlamaIndex connect to MCP servers?
Can I combine MCP tools with vector stores?
Does LlamaIndex support async MCP calls?
Explore More MCP Servers
View all →
Customer.io
12 toolsSend behavior-driven emails, push notifications, and in-app messages triggered by what your users actually do in your product.
Fxiaoke
10 toolsLeading sales management and CRM platform in China — manage leads, opportunities, and approvals via AI.
Surfer SEO
10 toolsConnect your AI to Surfer SEO. Generate Content Editors, perform NLP SERP audits, and extract high-ranking keyword guidelines directly from the terminal.
Together AI
7 toolsGenerate code, evaluate embeddings, and deploy open-source LLMs instantly from your local agent via Together AI's infrastructure.