How to Use the NetBird MCP in Google ADK

Q: How do I register the NetBird MCP Server with Google ADK?

Instantiate McpToolset with the server's HTTP endpoint and pass it to your LlmAgent tools list. This exposes the networking tools to your Gemini models instantly.

Q: Can Google ADK automate NetBird MSP tenant setup?

Yes, your agent can call createmsptenant and verify DNS records to bootstrap isolated environments. This makes it easy to scale customer onboarding using Gemini's structured output.

Deploy enterprise-scale network automation by connecting Google ADK agents directly to your NetBird overlay networks.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect NetBird MCP to Google ADK

Create your Vinkius account to connect NetBird to Google ADK 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 NetBird with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Analyze NetBird Network Logs with Google ADK

Enterprise NetBird networks generate massive amounts of telemetry that can overwhelm standard Google ADK tools. Your Google ADK agent pulls live activity using `list_audit_events` and `list_network_traffic_events` via this MCP Server to feed network states directly into Gemini's massive context window. This allows the Gemini model to analyze hours of NetBird connection history in a single pass. By combining this NetBird integration with your BigQuery datasets, the Google ADK agent can cross-reference physical office access logs with virtual peer connections. It flags anomalies instantly and runs `update_peer` to disable compromised NetBird endpoints before lateral movement occurs.

Manage Multi-Tenant Environments via Gemini

Managing hundreds of client networks requires rigid NetBird isolation inside your Google ADK agent workflow. Your Google ADK agent uses `create_msp_tenant` and `verify_msp_tenant_dns` to provision clean, separated NetBird networks for new customers automatically. It maps domains and configures NetBird nameservers without manual engineering intervention. Using Gemini's reasoning capabilities, the Google ADK agent evaluates incoming tenant requests and configures custom NetBird routing rules. It invokes `create_network_router` to establish dedicated NetBird pathways, ensuring zero cross-tenant traffic leakage.

Automate Posture Checks for Google Cloud Assets

Cloud workloads must meet strict compliance baselines before joining your NetBird overlay. This MCP Server lets your Google ADK agent run `create_posture_check` to enforce operating system versions, geographic boundaries, and specific process requirements. If a peer falls out of compliance, the Google ADK agent updates its NetBird access group using `update_group`. Google ADK lets you restrict which NetBird tools are exposed using the `tool_names` filter. This ensures your cloud-hosted Google ADK agent can only view NetBird states via `get_network` without having the authority to delete core infrastructure.

Setup guide

Set up NetBird MCP in Google ADK

Prerequisites

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

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with NetBird tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="NetBird_agent",
    model="gemini-2.0-flash",
    instruction="You have access to NetBird tools via MCP.",
    tools=mcp_tools,
)

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 NetBird. 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 NetBird 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 NetBird MCP in Google ADK

Instantiate `McpToolset` with the server's HTTP endpoint and pass it to your `LlmAgent` tools list. This exposes the networking tools to your Gemini models instantly.

Yes, your agent can call `create_msp_tenant` and verify DNS records to bootstrap isolated environments. This makes it easy to scale customer onboarding using Gemini's structured output.

You store your NetBird API tokens in Google Cloud Secret Manager. The ADK agent retrieves them at runtime, ensuring no plaintext credentials reside in your codebase or agent prompts.

Yes, Gemini's large context window allows the agent to ingest thousands of rows from `list_network_traffic_events`. It can identify complex traffic patterns or persistent connection failures across your entire network.

All NetBird peer metadata, routing paths, and posture profiles are processed inside Google's secure VPC boundary. The server runs in a zero-trust sandbox, preventing external access to your network topology.

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