# ProductBrain

> ProductBrain is a freemium MCP server for productivity. MCP server for driving a ProductBrain plan of goals, needs, bets and jobs from any agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** Web, API, CLI
- **Website:** https://productbrain.com
- **Repository:** https://github.com/moxzas/productbrain-mcp
- **MCP Registry name:** io.github.moxzas/productbrain
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-16

## About

ProductBrain organizes a product plan as a tree: goals with a measure, user needs beneath them, bets on how to meet each need, and jobs that are observable checkpoints. Its pitch is that an agent works from this plan instead of loose files, and that a job counts as done only when the result is verified in production.

This MCP server is a deliberately thin shim over the versioned v1 REST API, one tool per endpoint, with the API's coaching metadata passed back so an agent can self-correct. Tools cover semantic search, bulk reads, tree context, mutation with idempotency keys, phases, a story-mapping workflow, OKF export and a changelog. Others drive the live canvas, manage projects, webhooks and public share links.

A ProductBrain API key is required, and the README says the free tier includes API access. Plans listed on the site range from free to $12, $19 and $99 a month, with credits, seats and node limits varying.

## Features

- **Plan search:** Runs semantic search over the plan.
- **Tree and nodes:** Reads nodes and their surrounding context.
- **Safe mutation:** Creates, updates and deletes nodes with idempotency keys.
- **Workflow runner:** Runs the story-mapping workflow.
- **Live canvas control:** Sets and reads the live view.
- **Webhooks and share links:** Manages webhooks and public read-only links.

## Good for

- Let a coding agent update plan status as it ships
- Search the plan before starting a task
- Export a plan as portable OKF files
- Share a read-only view with stakeholders

## Install

### Claude Code (Terminal)

```sh
claude mcp add productbrain --env PRODUCTBRAIN_API_KEY='<PRODUCTBRAIN_API_KEY>' -- npx -y @productbrain-com/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "productbrain": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@productbrain-com/mcp"
      ],
      "env": {
        "PRODUCTBRAIN_API_KEY": "<PRODUCTBRAIN_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `search`: Semantic search over the plan.
- `list_nodes`: Bulk read of nodes.
- `get_tree`: A node in context.
- `mutate`: Creates, updates or deletes nodes and phases.
- `list_iterations`: Lists phases.
- `run_workflow`: Runs the story-mapping workflow.
- `export_okf`: Exports the plan as an OKF bundle.
- `get_changelog`: Plan history.
- `set_view`: Drives the live canvas.
- `read_view`: Reads the live canvas state.
- `list_projects`: Lists projects.
- `create_project`: Creates a project.
- `rename_project`: Renames a project.
- `archive_project`: Archives a project.
- `list_webhooks`: Lists webhooks.
- `create_webhook`: Registers a webhook.
- `update_webhook`: Updates a webhook.
- `delete_webhook`: Deletes a webhook.
- `create_share_link`: Creates a public read-only link.
- `list_share_links`: Lists share links.

## FAQ

### Do I need a key?

Yes, a pb_ API key; the free tier includes API access.

### Is it a separate API?

No. Each tool maps to one v1 REST endpoint.

### What does it cost?

Free tiers exist; paid plans listed are $12, $19 and $99 per month.

### How do I install it?

Run npx -y @productbrain-com/mcp with your key set in the environment.

### Is ProductBrain free?

ProductBrain has a free plan, with paid plans for more usage or features. Paid plans start at $12 a month.

### How do I add ProductBrain to Claude Code?

Run this command in your terminal: claude mcp add productbrain --env PRODUCTBRAIN_API_KEY='<PRODUCTBRAIN_API_KEY>' -- npx -y @productbrain-com/mcp

### What are the best alternatives to ProductBrain?

The closest alternatives to ProductBrain are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/productbrain
