NetBird MCP Server for OpenAI Agents SDKGive OpenAI Agents SDK instant access to 89 tools to Accept User Invite, Approve User, Change User Password, and more
The OpenAI Agents SDK enables production-grade agent workflows in Python. Connect NetBird through Vinkius and your agents gain typed, auto-discovered tools with built-in guardrails. no manual schema definitions required.
Ask AI about this MCP Server for OpenAI Agents SDK
The NetBird MCP Server for OpenAI Agents SDK is a standout in the Cloud Infrastructure category — giving your AI agent 89 tools to work with, ready to go from day one.
Vinkius delivers Streamable HTTP and SSE to any MCP client
import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerStreamableHttp
async def main():
# Your Vinkius token. get it at cloud.vinkius.com
async with MCPServerStreamableHttp(
url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
) as mcp_server:
agent = Agent(
name="NetBird Assistant",
instructions=(
"You help users interact with NetBird. "
"You have access to 89 tools."
),
mcp_servers=[mcp_server],
)
result = await Runner.run(
agent, "List all available tools from NetBird"
)
print(result.final_output)
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 NetBird MCP Server
Connect your NetBird account to any AI agent and take full control of your private network infrastructure through natural conversation.
The OpenAI Agents SDK auto-discovers all 89 tools from NetBird through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries NetBird, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
What you can do
- Account Management — List and update account settings, including peer login expiration and network ranges using
list_accountsandupdate_account. - User Administration — Create service users, invite regular users, and manage roles or block statuses with
list_users,create_user, andupdate_user. - Access Control — Approve or reject pending users and manage user invitations efficiently using
approve_userandreject_user. - Security & Identity — Change user passwords for embedded IdP and retrieve current user information via
get_current_userandchange_user_password. - Invitation Workflow — Generate, regenerate, and track user invite links to scale your network using
list_user_invitesandcreate_user_invite.
The NetBird MCP Server exposes 89 tools through the Vinkius. Connect it to OpenAI Agents SDK in under two minutes — credentials fully managed, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.
All 89 NetBird tools available for OpenAI Agents SDK
When OpenAI Agents SDK connects to NetBird through Vinkius, your AI agent gets direct access to every tool listed below — spanning zero-trust, vpn, network-management, 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.
Accept user invite on NetBird
Accept invite and set password (unauthenticated)
Approve user on NetBird
Approve a pending user
Change user password on NetBird
Change user password (embedded IdP only)
Create group on NetBird
Create a group
Create msp tenant on NetBird
Create a new MSP tenant
Create nameserver on NetBird
Create a nameserver group
Create network on NetBird
Create a network
Create network resource on NetBird
Create a resource (host, subnet, or domain) in a network
Create network router on NetBird
Create a router in a network
Create policy on NetBird
Create a policy with rules (action, protocol, ports, sources, destinations)
Create posture check on NetBird
Create a posture check (version, OS, geo-location, network range, or process)
Create route on NetBird
Create a route (Deprecated)
Create setup key on NetBird
Create a setup key (one-off or reusable)
Create temporary access peer on NetBird
Create a temporary access peer
Create user on NetBird
Create a service user or invite a regular user
Create user invite on NetBird
Create a user invite link
Create user token on NetBird
Create a new personal access token
Delete account on NetBird
Delete a NetBird account and all resources
Delete group on NetBird
Delete a group
Delete nameserver on NetBird
Delete nameserver group
Delete network on NetBird
Delete a network
Delete network resource on NetBird
Delete network resource
Delete network router on NetBird
Delete network router
Delete peer on NetBird
Delete a peer
Delete policy on NetBird
Delete a policy
Delete posture check on NetBird
Delete a posture check
Delete route on NetBird
Delete a route (Deprecated)
Delete setup key on NetBird
Delete a setup key
Delete user on NetBird
Remove a user
Delete user invite on NetBird
Delete a user invite
Delete user token on NetBird
Delete a token
Get current user on NetBird
Retrieve current user info
Get dns settings on NetBird
Retrieve global DNS settings
Get group on NetBird
Retrieve group details
Get nameserver on NetBird
Retrieve nameserver group details
Get network on NetBird
Retrieve network details
Get network resource on NetBird
Retrieve network resource details
Get network router on NetBird
Retrieve network router details
Get peer on NetBird
Retrieve peer details
Get policy on NetBird
Retrieve policy details
Get posture check on NetBird
Retrieve posture check details
Get public user invite on NetBird
Get public invite info (unauthenticated)
Get route on NetBird
Retrieve route details (Deprecated)
Get setup key on NetBird
Retrieve setup key details
Get user token on NetBird
Retrieve a specific token
Invite msp tenant on NetBird
Invite an existing account as a tenant
List accessible peers on NetBird
List peers accessible by this peer
List accounts on NetBird
List all NetBird accounts
List all network routers on NetBird
List all routers across all networks
List audit events on NetBird
List all audit events (activity, initiator, target)
List cities on NetBird
List city names for a country
List countries on NetBird
List all ISO 3166-1 alpha-2 country codes
List groups on NetBird
List all groups
List msp tenants on NetBird
List all MSP tenants
List nameservers on NetBird
List all nameserver groups
List network resources on NetBird
List resources in a network
List network routers on NetBird
List routers in a network
List network traffic events on NetBird
List network traffic events (Cloud-only, experimental)
List networks on NetBird
List all networks
List peers on NetBird
List all network peers
List policies on NetBird
List all policies
List posture checks on NetBird
List all posture checks
List proxy events on NetBird
List reverse proxy access logs
List routes on NetBird
List all routes (Deprecated)
List setup keys on NetBird
List all setup keys
List user invites on NetBird
List pending user invites
List user tokens on NetBird
List all tokens for a user
List users on NetBird
List all users
Regenerate user invite on NetBird
Regenerate an invite token
Reject user on NetBird
Reject a pending user
Resend user invite on NetBird
Resend user invitation
Respond msp tenant invite on NetBird
Accept or decline an MSP invitation
Unlink msp tenant on NetBird
Unlink a tenant to a new owner
Update account on NetBird
Update account settings (e.g., peer login expiration, network range)
Update dns settings on NetBird
Update DNS settings (e.g., disabled management groups)
Update group on NetBird
Update group name, peers, or resources
Update msp tenant on NetBird
Update tenant name or access groups
Update msp tenant subscription on NetBird
Create/update tenant subscription
Update nameserver on NetBird
Update nameserver group
Update network on NetBird
Update network name/description
Update network resource on NetBird
Update network resource
Update network router on NetBird
Update network router
Update peer on NetBird
Update peer name, SSH status, or IP
Update policy on NetBird
Update policy
Update posture check on NetBird
Update posture check
Update route on NetBird
Update route (Deprecated)
Update setup key on NetBird
Update key (revoke or change auto-groups)
Update user on NetBird
Update user role, auto-groups, or block status
Verify msp tenant dns on NetBird
Verify tenant domain DNS challenge
Connect NetBird to OpenAI Agents SDK via MCP
Follow these steps to wire NetBird into OpenAI Agents SDK. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Install the SDK
pip install openai-agents in your Python environmentReplace the token
[YOUR_TOKEN_HERE] with your Vinkius token from cloud.vinkius.comRun the script
python agent.pyExplore tools
Why Use OpenAI Agents SDK with the NetBird MCP Server
OpenAI Agents SDK provides unique advantages when paired with NetBird through the Model Context Protocol.
Native MCP integration via `MCPServerSse`, pass the URL and the SDK auto-discovers all tools with full type safety
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
NetBird + OpenAI Agents SDK Use Cases
Practical scenarios where OpenAI Agents SDK combined with the NetBird MCP Server delivers measurable value.
Automated workflows: build agents that query NetBird, process the data, and trigger follow-up actions autonomously
Multi-agent orchestration: create specialist agents. one queries NetBird, another analyzes results, a third generates reports
Data enrichment pipelines: stream data through NetBird tools and transform it with OpenAI models in a single async loop
Customer support bots: agents query NetBird to resolve tickets, look up records, and update statuses without human intervention
Example Prompts for NetBird in OpenAI Agents SDK
Ready-to-use prompts you can give your OpenAI Agents SDK agent to start working with NetBird immediately.
"List all users in my NetBird account."
"Create a new user invite link."
"Show me the details of the current authenticated user."
Troubleshooting NetBird MCP Server with OpenAI Agents SDK
Common issues when connecting NetBird to OpenAI Agents SDK through Vinkius, and how to resolve them.
MCPServerStreamableHttp not found
pip install --upgrade openai-agentsAgent not calling tools
NetBird + OpenAI Agents SDK FAQ
Common questions about integrating NetBird MCP Server with OpenAI Agents SDK.
How does the OpenAI Agents SDK connect to MCP?
MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.Can I use multiple MCP servers in one agent?
MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.Does the SDK support streaming responses?
Explore More MCP Servers
View all →
Common Room
10 toolsEnable your AI agent to manage community contacts, segments, and activities via the Common Room API.

LangSmith (LLM Observability & Hub)
6 toolsMonitor LLM apps via LangSmith — track traces, audit prompt templates, and manage evaluation datasets.

Miro
8 toolsBrainstorm, plan, and design together on an infinite visual canvas that brings distributed teams into the same creative space.

NVIDIA Vision
9 toolsGenerate images, analyze visuals, detect objects, and caption images via NVIDIA Vision APIs.
