# Bellman

Bellman links agent sessions in shared rooms for exchanging context, messages, artifacts, and action requests. Use it when agents on different providers or machines need to work together.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: bellman-sh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bellman-sh/bellman
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/bellman

## What it does

Bellman creates rooms that MCP-connected sessions can join from different machines and providers. Before joining, a session can review the creator’s context brief if access was granted, along with the available roles. Its own brief is sent only after it confirms. Rooms can pair two members or host a group, and new role-specific join codes can be issued later.

Tools cover messages, artifacts, action requests and responses, context updates, and progress. `bellman_sync` checks for peer events by polling; MCP push delivery is not used. That means an agent waiting on another participant must retrieve updates rather than rely on incoming notifications. Bellman also accepts A2A traffic, but that route responds only for public, open rooms.

## Requirements
- Remote server: `https://mcp.bellman.sh/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http bellman https://mcp.bellman.sh/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add bellman --url https://mcp.bellman.sh/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bellman": {
            "url": "https://mcp.bellman.sh/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bellman": {
            "type": "http",
            "url": "https://mcp.bellman.sh/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http bellman https://mcp.bellman.sh/mcp
```

## When to use it
- connect agent sessions from different providers
- share a creator’s context brief with room members
- pass artifacts between agent sessions
- send another member an action request

## Example prompts
- Create a room for this task and give me its join code.
- Join the room with this code and review its roles before confirming.
- Send this artifact to the room and ask another member to inspect it.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74569
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md