Context for your tools.

Start with the CLI

An agent that can run commands can use the documented search and ask workflows against a brain you explicitly make available. Use -C to select the brain, keep authentication private, and review any command that changes personal records.

MCP is still evolving

serenity -C ~/my-brain serve --stdio starts the MCP transport. Current source also supports authenticated Streamable HTTP with serve --http. Against a real brain, current source exposes five memory tools: recall, remember, entity, synthesize, and forget. Use -C to select that brain. If the path is not a brain, the transport serves the bare protocol with an empty registry. The older packaged release differs.

serenity connect reports token status; automatic MCP configuration and hook installation are not yet implemented in the documented CLI. Token rotation uses serenity connect --rotate-token.

Server interfaces

Server work is progressing independently of the packaged release. Consult the current HTTP operator guide and MCP operator guide for authentication, bind configuration and exact exposed capabilities.

Embedding in Go

Go applications can use the read-only pkg/serenity package to access a brain in process. The embedding contract defines its scope and ownership rules.