What features does Netbird MCP server provide?

Q: What features does Netbird MCP server provide?

Netbird API integration: Uses the Netbird API to access configuration and status, exposing select read-only resources as MCP tools.. Configurable API endpoint: API endpoint can be customized to point to different Netbird hosts; defaults to api.netbird.io.. Secure token-based authentication: Authenticates to the Netbird API using a token provided via NETBIRD_API_TOKEN.. 1:1 resource-to-tool mapping: Provides a 1:1 mapping of selected read-only Netbird API resources to MCP tools.. Exposed MCP tools: Tools include list_netbird_peers, list_netbird_port_allocations, list_netbird_groups, list_netbird_policies, list_netbird_posture_checks, list_netbird_networks, and list_netbird_nameservers.. Go-based with Grafana heritage: Implemented in Go and derived from Grafana Labs' MCP Server, leveraging MCP Go.. Developer tooling and debugging: Includes the MCP Inspector for debugging and testing MCP servers; supports stdio and SSE transports.. Docker and ToolHive deployment: Provides Docker image deployment guidance and ToolHive integration for easy hosting.

Netbird MCP Server 2025: Features & Setup Guide

Overview

Netbird MCP Server is a Model Context Protocol (MCP) server that provides LLMs with visibility into Netbird network configurations and status by exposing a curated set of read-only Netbird API resources as MCP tools. The server authenticates with Netbird using a token and can target different Netbird API hosts via NETBIRD_HOST (default api.netbird.io). Built in Go and leveraging MCP Go, the project is derived from Grafana Labs' MCP Server and is currently in development. It offers a 1:1 mapping of selected read-only Netbird API resources to MCP tools, enabling LLMs to query peers, port allocations, groups, policies, posture checks, networks, and nameservers. Tools can be extended by adding new tool implementations and updating API routes. The README documents installation from source or binary, as well as Docker and ToolHive deployment. Debugging and testing support is provided via the MCP Inspector, and the project includes guidance for running the server manually and in SSE mode for testing with LLM clients such as Claude Desktop or Codeium Windsurf.

Features

Netbird API integration

Uses the Netbird API to access configuration and status, exposing select read-only resources as MCP tools.

Configurable API endpoint

API endpoint can be customized to point to different Netbird hosts; defaults to api.netbird.io.

Secure token-based authentication

Authenticates to the Netbird API using a token provided via NETBIRD_API_TOKEN.

1:1 resource-to-tool mapping

Provides a 1:1 mapping of selected read-only Netbird API resources to MCP tools.

Exposed MCP tools

Tools include list_netbird_peers, list_netbird_port_allocations, list_netbird_groups, list_netbird_policies, list_netbird_posture_checks, list_netbird_networks, and list_netbird_nameservers.

Go-based with Grafana heritage

Implemented in Go and derived from Grafana Labs' MCP Server, leveraging MCP Go.

Developer tooling and debugging

Includes the MCP Inspector for debugging and testing MCP servers; supports stdio and SSE transports.

Docker and ToolHive deployment

Provides Docker image deployment guidance and ToolHive integration for easy hosting.