# Living Brain API

> Build with Living Brain: an API, SDKs, CLI, and MCP server that turn what your users read, write, and say into a knowledge vault that compounds.

Living Brain API

Now in early access

# Never start from zero again.

Living Brain turns everything your users read, write, and say into a knowledge vault
that compounds — surfacing non-obvious connections across conversations, documents,
meetings, and time.

[Quickstart](/docs/quickstart)

[API Reference](/api-reference)

MCP server

## Give your agent a brain.

Every Living Brain operation is a tool on the hosted MCP server. Paste one snippet into
Claude Code, Codex, Cursor, or VS Code and your agent can capture, search, and recall
knowledge across sessions.

[Read the MCP guide →](/mcp)

CLI

## Or let it use the terminal.

Any coding agent that can run shell commands can use the `livingbrain` CLI directly.
Install it, set your key, and ask the agent to save or find something.

[Read the CLI guide →](/cli)

## Start here

#### [Guides](/docs/quickstart)

Quickstart, authentication, core concepts, and how to capture, search, and sync a brain.

#### [SDKs](/sdk/typescript)

Typed clients for TypeScript and Python, so you can call the API without hand-rolling requests.

#### [CLI](/cli)

Call every endpoint from your terminal or CI with the `livingbrain` command.

#### [MCP](/mcp)

Connect Claude Code, Cursor, or VS Code to the hosted MCP server and use a brain as agent memory.

> Build with Living Brain: an API, SDKs, CLI, and MCP server that turn what your users read, write, and say into a knowledge vault that compounds.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.livingbrain.com/_mcp/server

## Docs

- [Quickstart](https://docs.livingbrain.com/docs/quickstart.md): Create a brain, capture something, and read it back.
- [Authentication](https://docs.livingbrain.com/docs/authentication.md): Every request carries an API key and a subject.
- [Core concepts](https://docs.livingbrain.com/docs/concepts.md): Brains, captures, sources, pages, buckets, and connections.
- [Capturing knowledge](https://docs.livingbrain.com/docs/capturing.md): Push notes, links, files, transcripts, and chat turns into a brain.
- [Pages and buckets](https://docs.livingbrain.com/docs/pages.md): Read, edit, organize, archive, and delete the brain's compiled knowledge.
- [Search and prompt context](https://docs.livingbrain.com/docs/search.md): Find pages, and feed the right slice of a brain into an LLM.
- [Change feed and webhooks](https://docs.livingbrain.com/docs/changes.md): Keep an external system in sync with a brain.
- [Slack integration](https://docs.livingbrain.com/docs/slack.md): Install Living Brain in a Slack workspace and route brain notifications to channels.
- [Pagination](https://docs.livingbrain.com/docs/pagination.md): Offset pagination, handled for you.
- [Errors](https://docs.livingbrain.com/docs/errors.md): The error envelope, status codes, and retry behaviour.
- [TypeScript SDK](https://docs.livingbrain.com/sdk/typescript.md): @livingbrain/sdk — fully typed, works in Node and the browser.
- [Python SDK](https://docs.livingbrain.com/sdk/python.md): livingbrain — sync and async clients with Pydantic v2 models.
- [CLI](https://docs.livingbrain.com/cli.md): livingbrain — every API operation as a command, for scripts, terminals, and agents.
- [MCP server](https://docs.livingbrain.com/mcp.md): Every Living Brain API operation as a tool for Claude, Cursor, and other MCP clients.

## API Docs

- API Reference > Workspace [Search pages](https://docs.livingbrain.com/api-reference/workspace/search-pages.md)
- API Reference > Workspace [Prompt index](https://docs.livingbrain.com/api-reference/workspace/prompt-index.md)
- API Reference > Workspace [Connection graph](https://docs.livingbrain.com/api-reference/workspace/graph.md)
- API Reference > Workspace [List pages](https://docs.livingbrain.com/api-reference/workspace/list-pages.md)
- API Reference > Workspace [Per-bucket page counts](https://docs.livingbrain.com/api-reference/workspace/buckets.md)
- API Reference > Workspace [Read a page](https://docs.livingbrain.com/api-reference/workspace/get-page.md)
- API Reference > Workspace [Delete a page](https://docs.livingbrain.com/api-reference/workspace/delete-permanently.md)
- API Reference > Workspace [Page version history](https://docs.livingbrain.com/api-reference/workspace/page-versions.md)
- API Reference > Workspace [Connections for a page](https://docs.livingbrain.com/api-reference/workspace/page-connections.md)
- API Reference > Workspace [Edit page content](https://docs.livingbrain.com/api-reference/workspace/edit-content.md)
- API Reference > Workspace [Move a page](https://docs.livingbrain.com/api-reference/workspace/move-bucket.md)
- API Reference > Workspace [Pin or unpin a page](https://docs.livingbrain.com/api-reference/workspace/pin.md)
- API Reference > Workspace [Rename a page](https://docs.livingbrain.com/api-reference/workspace/rename.md)
- API Reference > Workspace [Archive a page](https://docs.livingbrain.com/api-reference/workspace/archive.md)
- API Reference > Workspace [Restore a page](https://docs.livingbrain.com/api-reference/workspace/restore.md)
- API Reference > Workspace [Recover a page](https://docs.livingbrain.com/api-reference/workspace/recover.md)
- API Reference > Workspace [Resolve a page](https://docs.livingbrain.com/api-reference/workspace/resolve.md)
- API Reference > Workspace [Recover a page (legacy)](https://docs.livingbrain.com/api-reference/workspace/reviewed.md)
- API Reference > Workspace [List change-feed events](https://docs.livingbrain.com/api-reference/workspace/changes.md)
- API Reference > Workspace [Acknowledge a change](https://docs.livingbrain.com/api-reference/workspace/ack-change.md)
- API Reference > Workspace [Acknowledge all](https://docs.livingbrain.com/api-reference/workspace/ack-all.md)
- API Reference > Workspace [List connections](https://docs.livingbrain.com/api-reference/workspace/list-connections.md)
- API Reference > Workspace [Dismiss a connection](https://docs.livingbrain.com/api-reference/workspace/ack-connection.md)
- API Reference > Workspace [Brain health score](https://docs.livingbrain.com/api-reference/workspace/get-score.md)
- API Reference > Workspace [Score trend history](https://docs.livingbrain.com/api-reference/workspace/score-history.md)
- API Reference > Workspace [Score suggestions](https://docs.livingbrain.com/api-reference/workspace/score-suggestions.md)
- API Reference > Workspace [Get the brain profile](https://docs.livingbrain.com/api-reference/workspace/get-profile.md)
- API Reference > Workspace [Update the profile](https://docs.livingbrain.com/api-reference/workspace/update-profile.md)
- API Reference > Workspace [Profile suggestions](https://docs.livingbrain.com/api-reference/workspace/profile-suggestions.md)
- API Reference > Workspace [Export as markdown](https://docs.livingbrain.com/api-reference/workspace/export-markdown.md)
- API Reference > Brains [List brains](https://docs.livingbrain.com/api-reference/brains/list.md)
- API Reference > Brains [Create a brain](https://docs.livingbrain.com/api-reference/brains/create.md)
- API Reference > Brains [Bulk brain stats](https://docs.livingbrain.com/api-reference/brains/bulk-stats.md)
- API Reference > Brains [Get a brain](https://docs.livingbrain.com/api-reference/brains/get.md)
- API Reference > Brains [Delete a brain](https://docs.livingbrain.com/api-reference/brains/remove.md)
- API Reference > Brains [Update a brain](https://docs.livingbrain.com/api-reference/brains/update.md)
- API Reference > Brains [Brain stats](https://docs.livingbrain.com/api-reference/brains/stats.md)
- API Reference > Brains [Update brief settings](https://docs.livingbrain.com/api-reference/brains/update-brief-settings.md)
- API Reference > Brains [Run the daily brief](https://docs.livingbrain.com/api-reference/brains/run-brief.md)
- API Reference > Captures [Push a capture](https://docs.livingbrain.com/api-reference/captures/capture.md)
- API Reference > Captures [Push a capture batch](https://docs.livingbrain.com/api-reference/captures/capture-batch.md)
- API Reference > Captures [Push a chat turn](https://docs.livingbrain.com/api-reference/captures/capture-chat-turn.md)
- API Reference > Captures [List ingest sources](https://docs.livingbrain.com/api-reference/captures/list-sources.md)
- API Reference > Captures [Retry an ingest source](https://docs.livingbrain.com/api-reference/captures/retry-source.md)
- API Reference > Captures [Delete an ingest source](https://docs.livingbrain.com/api-reference/captures/remove-source.md)
- API Reference > Webhooks [List webhooks](https://docs.livingbrain.com/api-reference/webhooks/list.md)
- API Reference > Webhooks [Register a webhook](https://docs.livingbrain.com/api-reference/webhooks/create.md)
- API Reference > Webhooks [Delete a webhook](https://docs.livingbrain.com/api-reference/webhooks/remove.md)
- API Reference > Webhooks [Update a webhook](https://docs.livingbrain.com/api-reference/webhooks/update.md)
- API Reference > Telegram [Telegram status](https://docs.livingbrain.com/api-reference/telegram/status.md)
- API Reference > Telegram [Connect Telegram](https://docs.livingbrain.com/api-reference/telegram/connect.md)
- API Reference > Telegram [Disconnect Telegram](https://docs.livingbrain.com/api-reference/telegram/disconnect.md)
- API Reference > Slack [Slack status](https://docs.livingbrain.com/api-reference/slack/status.md)
- API Reference > Slack [Start Slack OAuth](https://docs.livingbrain.com/api-reference/slack/start-oauth.md)
- API Reference > Slack [Confirm Slack OAuth](https://docs.livingbrain.com/api-reference/slack/confirm-oauth.md)
- API Reference > Slack [List Slack channels](https://docs.livingbrain.com/api-reference/slack/channels.md)
- API Reference > Slack [Bind a Slack channel](https://docs.livingbrain.com/api-reference/slack/bind.md)
- API Reference > Slack [Unbind a Slack channel](https://docs.livingbrain.com/api-reference/slack/unbind.md)
- API Reference > Slack [Update a Slack binding](https://docs.livingbrain.com/api-reference/slack/update-binding.md)
- API Reference > Slack [Disconnect Slack](https://docs.livingbrain.com/api-reference/slack/disconnect-installation.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://docs.livingbrain.com/openapi.json)
- [OpenAPI YAML](https://docs.livingbrain.com/openapi.yaml)