Advertise
MCP.so
Sign In

Netbird MCP Server

@shinycongre

Repository

Basic information

Category

Other

License

Apache-2.0 license

Transports

stdio

Author

shinycongre

About Netbird MCP Server

MCP Server for Netbird

#mcp-netbird#netbird#mcp-server

Netbird MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-netbird-shinycongre": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@aantti/mcp-netbird",
        "--client",
        "claude"
      ]
    }
  }
}

Netbird MCP Server tools

7

All peers

All ingress ports for `peerId`

All groups

All policies

All posture checks

All networks

All nameserver groups

Overview

What is Netbird MCP Server?

Netbird MCP Server is a Model Context Protocol (MCP) server that provides LLMs with read-only access to a Netbird network configuration and status. It uses the Netbird API to expose a set of tools for querying peers, groups, policies, posture checks, networks, nameserver groups, and port allocations. It is intended for developers and administrators who want to interact with Netbird through AI assistants.

How to use Netbird MCP Server?

Install the mcp-netbird binary from source, via go install, or through Smithery. Set the NETBIRD_API_TOKEN environment variable (and optionally NETBIRD_HOST). Add the server configuration (command: mcp-netbird, with the token as an env variable) to your MCP client’s config file (e.g., ~/.codeium/windsurf/mcp_config.json for Windsurf). Then ask the assistant questions about your Netbird network, such as “Can you explain my Netbird peers, groups and policies to me?”.

Key features of Netbird MCP Server

  • Token‑based authentication with the Netbird API
  • Configurable API endpoint (default api.netbird.io)
  • Read‑only tool mapping of several Netbird API resources
  • Supports both stdio and SSE transport modes
  • Can be deployed via Docker or ToolHive

Use cases of Netbird MCP Server

  • Query all peers in a Netbird network from an AI chat
  • List groups, policies, and posture checks for security review
  • Retrieve DNS nameserver group configurations
  • Inspect ingress port allocations for a specific peer
  • Get an overview of network definitions without using the web console

Frequently asked questions

1

What does Netbird MCP Server do?

It exposes read‑only Netbird API endpoints as MCP tools so that LLMs can fetch information about peers, groups, policies, posture checks, networks, nameserver groups, and port allocations.

2

How do I install Netbird MCP Server?

You can install it from source (`make install`), via `go install`, or automatically through Smithery. Docker images can also be built and run.

3

What are the runtime requirements?

Netbird MCP Server requires Go (if building from source) and a valid Netbird API token. It runs as a binary and can be invoked via stdio or SSE.

4

Where does the data come from?

All data is retrieved live from the Netbird API. No local data storage is used; the server acts as a passthrough.

5

What transport protocols are supported?

The server supports both stdio (default) and SSE transport. SSE mode is enabled with the `--transport sse` flag and a bind address (e.g., `:8001`). Docker and ToolHive deployments also support SSE.

Comments

More Other MCP servers

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Advertise