Skip to main content
The ProductBrain MCP server lets an MCP client — Claude Desktop, Claude Code, Cursor — drive your plan directly: search, read, mutate, run the planning methodology, and read/drive the live view.
A thin shim, on purpose. The server is a thin transport over ProductBrain’s versioned v1 REST API — each tool is one call to an existing /api/v1 endpoint. The REST contract stays canonical: it’s stable when the MCP spec churns, you can drop to raw HTTP or bring your own LLM any time, and responses carry the same in-band _meta coaching the API returns.

​
Install

// claude_desktop_config.json
{
  "mcpServers": {
    "productbrain": {
      "command": "npx",
      "args": ["-y", "@productbrain-com/mcp"],
      "env": {
        "PRODUCTBRAIN_API_KEY": "pb_your_key",
        "PRODUCTBRAIN_PROJECT_ID": "your-project-id"
      }
    }
  }
}
Cursor and other clients: add an mcpServers entry with the same command / args / env.

​
Configuration

VariableRequiredDefault
PRODUCTBRAIN_API_KEYyes— (your pb_ key from the app’s API Keys modal)
PRODUCTBRAIN_PROJECT_IDno— (tools also accept a projectId argument)
PRODUCTBRAIN_API_URLnohttps://productbrain.com/api/v1

​
Tools

ToolMaps toUse
searchGET /searchSemantic search — use first for any lookup
list_nodesGET /nodesBulk read, optional type / iteration filter
get_treeGET /treeA node in context (ancestors / siblings / children / subtree)
mutatePOST /mutateCreate / update / delete nodes + phases; pass idempotencyKey to make retries safe
list_iterationsGET /iterationsPhases; current: true for the active one
run_workflowPOST /workflowStory-Mapping methodology (add / task-curate / phase-assign)
set_view / read_viewPOST /view-command, GET /view-stateDrive / read the live canvas
The complete contract — every endpoint, field, and validation rule — is the LLM Guide.