NetBird MCP Server for WindsurfGive Windsurf instant access to 89 tools to Accept User Invite, Approve User, Change User Password, and more
Windsurf brings agentic AI coding to a purpose-built IDE. Connect NetBird through Vinkius and Cascade will auto-discover every tool. ask questions, generate code, and act on live data without leaving your editor.
Ask AI about this MCP Server for Windsurf
The NetBird MCP Server for Windsurf 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
{
"mcpServers": {
"netbird": {
"url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}
}
}Vinkius Desktop App
The modern way to manage MCP Servers — no config files, no terminal commands. Install NetBird and 4,000+ MCP Servers from a single visual interface.





* 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.
Windsurf's Cascade agent chains multiple NetBird tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 89 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
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 Windsurf 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 Windsurf
When Windsurf 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 Windsurf via MCP
Follow these steps to wire NetBird into Windsurf. The entire setup takes under two minutes — your credentials stay safe behind Vinkius.
Open MCP Settings
Cmd+Shift+P and search "MCP"Add the server
mcp_config.jsonSave and reload
Start using NetBird
Why Use Windsurf with the NetBird MCP Server
Windsurf provides unique advantages when paired with NetBird through the Model Context Protocol.
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
JSON-based configuration means zero code changes: paste a URL, reload, and all 89 tools are immediately available
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
NetBird + Windsurf Use Cases
Practical scenarios where Windsurf combined with the NetBird MCP Server delivers measurable value.
Automated code generation: ask Cascade to fetch data from NetBird and generate models, types, or handlers based on real API responses
Live debugging: query NetBird tools mid-session to inspect production data while debugging without leaving the editor
Documentation generation: pull schema information from NetBird and have Cascade generate comprehensive API docs automatically
Rapid prototyping: combine NetBird data with Cascade's code generation to scaffold entire features in minutes
Example Prompts for NetBird in Windsurf
Ready-to-use prompts you can give your Windsurf 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 Windsurf
Common issues when connecting NetBird to Windsurf through Vinkius, and how to resolve them.
Server not connecting
NetBird + Windsurf FAQ
Common questions about integrating NetBird MCP Server with Windsurf.
How does Windsurf discover MCP tools?
mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.Can Cascade chain multiple MCP tool calls?
Does Windsurf support multiple MCP servers?
mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.Explore More MCP Servers
View all →
Plunk Email Marketing
8 toolsAutomate your email marketing via Plunk — send transactional emails, track events, and manage contacts.

Polygon.io
6 toolsAccess real-time and historical stock market data, including trades, quotes, aggregates, and company metadata directly via AI.

ActiveCampaign
5 toolsMarketing automation and CRM — manage contacts, deals, lists, and automations via AI.

PrestaShop
10 toolsBring your PrestaShop store to your AI — orchestrate orders, extract deep product metadata, and track inventory stock levels natively via chat.
