# ProductBrain [Health: Active]

**Category:** 📋 Product Management  
**Repository:** https://github.com/moxzas/productbrain-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/productbrain

## Description
Drive your ProductBrain product plan (goals, needs, bets, jobs) from any MCP client.

## Tools
Capabilities this server exposes over MCP:

- **search** — Semantic search — **use first** for any lookup
- **list_nodes** — Bulk read, optional type/iteration filter
- **get_tree** — A node in context (ancestors/siblings/children/subtree)
- **mutate** — Create/update/delete nodes + phases; pass `idempotencyKey` to make retries safe
- **list_iterations** — Phases; `current:true` for the active one
- **run_workflow** — Story-Mapping methodology (add / task-curate / phase-assign)
- **export_okf** — The plan as a portable OKF file bundle
- **get_changelog** — Plan history: every add/update/delete/restore, attributed to the app or a named agent
- **set_view** — Drive / read the live canvas
- **list_projects** — Projects you own or are a member of; `includeArchived` for the rest
- **create_project** — Bootstrap a brain — seeds the system "Later" phase. Pass an explicit `id`: `addProject` runs before mutate reads `Idempotency-Key`, so it is not retry-safe
- **rename_project** — Change the display name; the id is immutable
- **archive_project** — Hide/unhide without deleting (reversible)
- **list_webhooks** — Registered hooks with `lastStatus` — spot a failing receiver
- **create_webhook** — Register; returns the signing secret **once
- **update_webhook** — Change url/events in place, or `rotateSecret:true`. Prefer over delete+recreate
- **delete_webhook** — Remove a registration
- **create_share_link** — Mint a **public** read-only link; `expiresInDays` for a TTL
- **list_share_links** — Audit every token minted, with an `active` flag
- **revoke_share_link** — Kill a leaked or stale link
- **list_members** — Humans and agent seats on a project
- **add_agent_seat** — Mint an agent seat; the `pb_` key is returned **once** (Team tier)
- **invite_contributor** — Passwordless guest invite, scoped to the projects you name (Team tier)
- **revoke_member** — Remove a seat; an agent's key dies with its last membership
- **tier_status** — Your tier, API access, credit balance and limits — check before a large run
- **submit_feedback** — Tell the PB team what to improve: feature requests, friction, bugs, notes

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "productbrain": {
    "command": "npx",
    "args": ["-y","@productbrain-com/mcp"],
    "env": {
      "PRODUCTBRAIN_API_KEY": "",
      "PRODUCTBRAIN_PROJECT_ID": "",
      "PRODUCTBRAIN_API_URL": ""
    }
  }
}
```

**Requires environment variables:** `PRODUCTBRAIN_API_KEY`, `PRODUCTBRAIN_PROJECT_ID`, `PRODUCTBRAIN_API_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What ProductBrain MCP server does

ProductBrain MCP server gives MCP clients access to a ProductBrain product plan. It covers structured planning data such as goals, needs, bets, and jobs, along with phases and project membership. The server exposes read, write, workflow, administration, and sharing operations through MCP tools.

For plan discovery, `search` provides semantic lookup and is intended as the first tool for searches. `list_nodes` supports bulk reads with optional type and iteration filters, while `get_tree` returns a node with surrounding context such as ancestors, siblings, children, or a subtree. Changes go through `mutate`, which can create, update, or delete nodes and phases.

This fits the Product Management category when an agent needs to maintain a shared product plan rather than only answer questions about static documentation.

## How it works

The ProductBrain MCP server is a thin transport layer over ProductBrain's versioned v1 REST API. Each MCP tool corresponds to an API endpoint, and the API remains the underlying contract. Responses pass through the API's `_meta` coaching data so clients receive the same guidance returned by the REST service.

The plan tools include iteration lookup, story-mapping workflows, OKF export, and changelog access. `set_view` and `read_view` control and inspect the live canvas. Project tools list, create, rename, and archive projects; archiving is reversible. Webhook tools manage registrations and secrets, while share-link tools create public read-only links, audit them, and revoke them.

Membership tools list project members, add agent seats, invite contributors, and revoke access. `tier_status` reports the account tier, API access, credit balance, and limits. Team-only operations return a tier error when used with a Builder key.

## Setup and configuration

Install the published npm package with an MCP client's standard server configuration. The README provides examples for Claude Desktop and Claude Code using `npx -y @productbrain-com/mcp`; Cursor and other clients use the same command, arguments, and environment entries.

Set `PRODUCTBRAIN_API_KEY` to a `pb_` key from the ProductBrain application. `PRODUCTBRAIN_PROJECT_ID` is optional because tools can receive a project ID directly. `PRODUCTBRAIN_API_URL` is also optional and defaults to `https://productbrain.com/api/v1`.

The repository includes headless spike and parity scripts for testing against a real deployment. The documented approach uses a throwaway project, and the parity script archives its temporary project because no project-delete endpoint exists.

## Tools and capabilities

- Search and inspect plan data with semantic search, node lists, and contextual trees.
- Create, update, and delete nodes or phases, with idempotency support for `mutate` retries.
- Run the Story-Mapping workflow using add, task-curate, or phase-assign operations.
- Export the plan as an OKF file bundle and inspect its changelog.
- Manage projects, the live canvas, webhooks, public read-only links, members, agent seats, and contributor invitations.

## Limitations and notes

`create_project` is not retry-safe because its project-creation operation reads the idempotency header after the relevant mutation step. Supplying an explicit project ID is recommended. Webhook creation returns the signing secret only once, and adding an agent seat also returns its `pb_` key only once.

Public share links are read-only but accessible to anyone with the link, so revoke links that are leaked or no longer needed. Agent access is removed when the agent's last project membership is revoked. Team-tier tools require the Team tier. The source repository is MIT licensed, and the MCP registry name is `io.github.moxzas/productbrain`.

_Full upstream README: https://allmcps.com/mcp/productbrain/readme_