Server SDK (Python)
nimblebrain-server-sdk is the Python SDK for building MCP servers that run on NimbleBrain. Use it for a connector (a server alone, which the agent reaches through its tools) or for the server half of an app (a server plus its interface). It builds on FastMCP 4 and gives your server what a NimbleBrain host reads: tool annotations, change announcements, skills, facets, lifecycle handlers, host resources and the error contract. The interface half of an app is built with Synapse and served from this server with FastMCP’s AppConfig.
uv add nimblebrain-server-sdkOptional extras
Section titled “Optional extras”The core installs nothing heavy. Add an extra when your server needs it:
| Extra | Install | For |
|---|---|---|
[db] |
uv add 'nimblebrain-server-sdk[db]' |
A Postgres database shared by many tenants and workspaces, isolated by row-level security, with identity from the host. See Data. |
[observability] |
uv add 'nimblebrain-server-sdk[observability]' |
Metrics, structured logs and traces from one call. See Observability. |
[outbox] |
uv add 'nimblebrain-server-sdk[outbox]' |
Notifications the host picks up, recorded in the same transaction as the change. Includes [db] and [observability]. See Notifications. |
Where to go next
Section titled “Where to go next”QuickstartA minimal connector: install, write, run, test, connect.
GuidesTools, announcements, skills, facets, lifecycle, host resources, notifications and data.
TestingBoth protocol eras, the testing helpers, and identity for [db].
API referenceEvery public name, generated from the package's docstrings.
Which package do I need?The server SDK, Synapse and the API client, and how they pair.
Compatibility and stabilitySupported Python, FastMCP and mcp versions, and the 0.x policy.