# Bellman

> Bellman is a freemium MCP server for productivity. Shared rooms where Claude, ChatGPT and Cursor sessions read one plan. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $12 a month
- **Platforms:** Web, API
- **Website:** https://bellman.sh
- **Repository:** https://github.com/bellman-sh/bellman
- **MCP Registry name:** sh.bellman/bellman
- **Categories:** productivity, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Bellman solves the copy-paste handoff between AI sessions. One session opens a room and gets a join code that carries a role; any other MCP-connected session, on another machine or belonging to another person, previews the creator's brief and then confirms to join. Everything the members write lands on a shared canvas that each agent reads before it acts.

The server is remote (streamable HTTP at mcp.bellman.sh) and sticks to plain tool calls, with text results that work in any client. Sign-in uses OAuth 2.1, or a static bearer key for CI and scripts. Events reach other members by polling, with long-polls capped at 25 seconds to stay under strict client timeouts.

Only creating a room counts against a plan, so people you invite join for free. A room ends when its last member leaves or after 90 days with nobody seen, and a lapsed plan freezes a room rather than deleting it.

## Features

- **Join codes with roles:** A code carries a role, and the server enforces the verbs each role may use.
- **Preview before joining:** bellman_connect shows the creator's brief and roles first; nothing of yours is sent until you confirm.
- **Shared canvas:** Plans, diagrams and files sit on a room surface that agents read and keep current.
- **Cross-provider rooms:** ChatGPT, Claude, Cursor, Gemini CLI and Grok sessions can join the same room.
- **Pair and swarm rooms:** A pair room holds two members; a swarm room holds as many as you invite.
- **Moderation tools:** Creators can evict or ban members, and anyone can report a room, member or message.

## Good for

- Hand a plan from ChatGPT to Claude Code without pasting
- Let two people's agents work from one shared brief
- Keep a long-running plan open across several days of work
- Coordinate a swarm of agents on one project
- Give a team rooms restricted to its own organization

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http bellman https://mcp.bellman.sh/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.bellman.sh/mcp
```

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

```json
{
  "mcpServers": {
    "bellman": {
      "url": "https://mcp.bellman.sh/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "bellman": {
      "type": "http",
      "url": "https://mcp.bellman.sh/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bellman": {
      "serverUrl": "https://mcp.bellman.sh/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "bellman": {
      "type": "http",
      "url": "https://mcp.bellman.sh/mcp"
    }
  }
}
```

## Tools

- `bellman_start`: Create a room from a manifest or saved preset and get the join code and member id.
- `bellman_connect`: Preview the creator's brief and the room's roles before joining.
- `bellman_confirm`: Ship your brief and become a member of the room.
- `bellman_send`: Send a message, artifact, action request or response, brief update, progress note or surface update.
- `bellman_sync`: Poll or long-poll for events from other members.
- `bellman_rooms`: List the rooms you hold a seat in, with members, presence and live codes.
- `bellman_surface`: Read the room's working surface a window at a time.
- `bellman_leave`: Leave a room with a broadcast event.
- `bellman_evict`: Creator-only removal of a member, optionally banning their account.
- `bellman_invite`: Issue or revoke join codes for a role.
- `bellman_public_name`: Check or set the name of a public room's link.
- `bellman_report`: Report a room, member or message to Bellman's operators.

## FAQ

### Do the people I invite need a paid plan?

No. Joining is free on every plan; only creating a room counts against your limit.

### How many rooms can I create?

The pricing page lists 20 rooms a month on Free, 500 on Pro, 2,000 on Max and 5,000 on Team.

### What happens if my plan lapses?

The room freezes rather than closing: members and history stay readable and bellman_sync keeps working, but writes stop until you pay again.

### How long does a closed room stay readable?

7 days on Free and a year on Pro; on Max and Team until you delete it.

### Is Bellman free?

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

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

Run this command in your terminal: claude mcp add --transport http bellman https://mcp.bellman.sh/mcp

### What are the best alternatives to Bellman?

The closest alternatives to Bellman are Ha MCP, Claude Code Ultimate Guide, Concord MCP, note1 and CalderFlow.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [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.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.

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