NetBird MCP Server for Mastra AIGive Mastra AI instant access to 89 tools to Accept User Invite, Approve User, Change User Password, and more
Mastra AI is a TypeScript-native agent framework built for modern web stacks. Connect NetBird 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 NetBird MCP Server for Mastra AI 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 { 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: {
"netbird": {
url: "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
},
},
});
const tools = await mcpClient.getTools();
const agent = new Agent({
name: "NetBird Agent",
instructions:
"You help users interact with NetBird " +
"using 89 tools.",
model: openai("gpt-4o"),
tools,
});
const result = await agent.generate(
"What can I do with NetBird?"
);
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 NetBird MCP Server
Connect your NetBird account to any AI agent and take full control of your private network infrastructure through natural conversation.
Mastra's agent abstraction provides a clean separation between LLM logic and NetBird tool infrastructure. Connect 89 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
- 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 Mastra AI 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 Mastra AI
When Mastra AI 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 Mastra AI via MCP
Follow these steps to wire NetBird 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 NetBird MCP Server
Mastra AI provides unique advantages when paired with NetBird through the Model Context Protocol.
Mastra's agent abstraction provides a clean separation between LLM logic and tool infrastructure. add NetBird 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 NetBird 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
NetBird + Mastra AI Use Cases
Practical scenarios where Mastra AI combined with the NetBird MCP Server delivers measurable value.
Automated workflows: build multi-step agents that query NetBird, process results, and trigger downstream actions in a typed pipeline
SaaS integrations: embed NetBird as a first-class tool in your product's AI features with Mastra's clean agent API
Background jobs: schedule Mastra agents to query NetBird on a cron and store results in your database automatically
Multi-agent systems: create specialist agents that collaborate using NetBird tools alongside other MCP servers
Example Prompts for NetBird in Mastra AI
Ready-to-use prompts you can give your Mastra AI 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 Mastra AI
Common issues when connecting NetBird to Mastra AI through Vinkius, and how to resolve them.
createMCPClient not exported
npm install @mastra/mcpNetBird + Mastra AI FAQ
Common questions about integrating NetBird 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 →
GoTab
12 toolsManage your restaurant operations — menus, orders, and tabs via AI.

Mitto
27 toolsAutomate SMS messaging and 2FA verification via Mitto — send single or bulk messages, verify OTPs, and lookup phone numbers directly from your AI agent.

Fellow
12 toolsManage meeting notes and feedback via Fellow — list agenda items and decisions, track action items, handle recordings, and complete tasks directly from any AI agent.

Adobe Acrobat Sign
10 toolsSend, track, and manage e-signatures via Adobe Acrobat Sign — create agreements, check signing status, and access audit trails from any AI agent.
