v1.3.0 - MCP Server

What's New

MCP Server — 25 NetBird Tools for AI Assistants

NetBird Python Client now ships a built-in Model Context Protocol server.

Installation

```bash
pip install "netbird[mcp]"
```

Claude Desktop Configuration

```json
{
"mcpServers": {
"netbird": {
"command": "netbird-mcp",
"env": {
"NETBIRD_HOST": "api.netbird.io",
"NETBIRD_API_TOKEN": "your-api-token"
}
}
}
}
```

Changes

• 25 MCP tools for AI assistants via netbird-mcp CLI
• pip install "netbird[mcp]" optional dependency
• Minimum Python version raised to 3.10 (mcp requires 3.10+)

Full Changelog: https://github.com/drtinkerer/netbird-python-client/blob/main/CHANGELOG.md

v1.2.1 - Fix PolicyRule sources/destinations type

Bug Fixes

• PolicyRule sources / destinations — Fixed incorrect type that caused 400 "couldn't parse JSON request" when creating/updating policies.

  The NetBird API expects plain string group IDs on writes but returns full objects on reads. Changed from List[Dict] to List[Union[str, Dict]].

  Before (broken):

  rule = PolicyRule(
      sources=[{"id": "group-id"}],  # 400 error
      ...
  )

  After (correct):

  rule = PolicyRule(
      sources=["group-id"],  # works
      ...
  )

v1.2.0 - Full NetBird API Parity

What's New

Full API parity upgrade with NetBird's latest endpoints — 30+ resources, cloud namespace, and forward-compatible models.

New Resources

• Posture Checks, Geo Locations, DNS Zones, Identity Providers, Instance

Cloud Namespace (client.cloud.*)

• Services, Ingress, EDR (Falcon/Huntress/Intune/SentinelOne), MSP, Invoices, Usage, Event Streaming, IDP/SCIM

Enhancements

• Users: approve, reject, invites, password management
• Peers: temporary access, job management
• Events: proxy event logging
• Networks: global router listing
• PolicyRule: resource-based access control with camelCase aliases
• BaseModel: extra="allow" for forward-compatible API responses
• Routes: deprecation warnings (use Networks instead)
• Cloud host detection: warns when accessing cloud endpoints on self-hosted instances

Bugfixes

• Handle null API responses for empty lists
• Fix event streaming endpoint path

Stats

• 364 tests, 88% coverage
• Tested against both NetBird Cloud and self-hosted instances

See CHANGELOG.md for full details.