> ## Documentation Index
> Fetch the complete documentation index at: https://productbrain.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Reference

> Generated reference for the Product Brain MCP tool surface.

<Warning>
  **Early access** — Generated from MCP tool sources; schemas evolve. [**Join the Product Brain Community**](https://community.productbrain.io).
</Warning>

Product Brain exposes a compact MCP tool surface. Most tools are compound tools with an `action` parameter so clients do not need to load many single-purpose tool definitions.

Call `orient` first before substantive work.

## Tools (default — 10, always registered)

### `capture`

Capture

Actions: `batch`, `capture`

Source: `packages/mcp-server/src/tools/smart-capture.ts`

### `collections`

Collections

Actions: `audit`, `create`, `describe`, `export`, `label-apply`, `label-create`, `label-delete`, `label-list`, `label-remove`, `label-update`, `list`, `update`

Source: `packages/mcp-server/src/tools/collections.ts`

### `context`

Context

Actions: `brief`, `build`, `chain`, `changes`, `cross-cut`, `gather`, `incremental`, `last-verified-brief`, `neighborhood`

Source: `packages/mcp-server/src/tools/context.ts`

### `entries`

Entries

Actions: `batch`, `commit`, `get`, `history`, `list`, `move`, `search`, `update`, `verify`

Source: `packages/mcp-server/src/tools/entries.ts`

### `orient`

Orient

Actions: `record-activation`, `start`, `task`

Source: `packages/mcp-server/src/tools/orient.ts`

### `quality`

Quality

Actions: `audit`, `check`, `re-evaluate`, `verify-chain`

Source: `packages/mcp-server/src/tools/quality.ts`

### `relations`

Relations

Actions: `batch-create`, `create`, `delete`, `dismiss`, `find`, `suggest`

Source: `packages/mcp-server/src/tools/relations.ts`

### `session`

Session - Lifecycle & Facilitation

Actions: `close`, `commit-constellation`, `resume`, `start`, `status`, `wrapup-commit`, `wrapup-review`

Source: `packages/mcp-server/src/tools/session.ts`

### `workflows`

Workflows

Actions: `checkpoint`, `get-run`, `list`, `load-skill`, `start`

Source: `packages/mcp-server/src/tools/workflows.ts`

### `workspace`

Workspace

Actions: `audit`, `check`, `proposals-count`, `proposals-list`, `proposals-respond`, `self-test`, `status`, `usage`, `whoami`

Source: `packages/mcp-server/src/tools/workspace.ts`

## Module-gated tools (3 — off by default)

<Warning>
  These tools are **not** registered by default. Set `PB_MODULES=core,gitchain` (or include `gitchain` alongside whatever modules you already pass) to enable them.
</Warning>

### `chain`

Chain

Requires: `PB_MODULES=core,gitchain`

Actions: `create`, `edit`, `get`, `list`, `version.commit`, `version.diff`, `version.history`, `version.list`, `version.revert`

Source: `packages/mcp-server/src/tools/gitchain.ts`

### `chain-review`

Chain Review

Requires: `PB_MODULES=core,gitchain`

Actions: `branch.conflicts`, `branch.create`, `branch.list`, `branch.merge`, `comment`, `gate`, `list-comments`, `resolve-comment`

Source: `packages/mcp-server/src/tools/gitchain.ts`

### `map`

Map

Requires: `PB_MODULES=core,gitchain`

Actions: `create`, `create-audience-set`, `get`, `list`, `slot.add`, `slot.list`, `slot.remove`, `slot.replace`, `suggest`, `version.commit`, `version.history`, `version.list`

Source: `packages/mcp-server/src/tools/maps.ts`