NetBird Full API Reference + Read-Only MCP Prototype
GET/api/agent-network/agent-config

Retrieve the caller's Agent Network agent config

Returns everything the caller needs to configure a local AI tool and nothing more - the account's Agent Network endpoint plus the providers and models the caller's own policies allow. Available to every authenticated user regardless of role; the response never contains provider credentials, policy or guardrail configuration, or providers the caller cannot reach.

3 status codes
200The caller-scoped Agent Network agent config
configuredbooleanrequired
False only when the account has no Agent Network set up. A caller that no policy covers yet still reads as configured, with an empty providers list.
endpointstringrequired
The account's Agent Network base URL, reachable over the NetBird tunnel only. Returned to every member of a configured account - it authorizes nothing on its own, since the gateway still refuses every request no policy permits. Empty when configured is false.
providersarray<object>required
The providers at least one of the caller's policies authorizes, in creation order. Empty when no policy covers the caller.
401Requires authentication
500Internal Server Error

Error handling

A 401 is returned: Requires authentication. A 500 is returned: Internal Server Error.