Bellman — Claude Code MCP server: collaboration across sessions
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.
claude mcp add --transport http bellman https://mcp.bellman.sh/mcpWhat Bellman 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.
What it helps with
- 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 for the agent
- 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.
How to install Bellman
Platform CLI: remote server
claude mcp add --transport http bellman https://mcp.bellman.sh/mcpPlatform CLI: remote server
codex mcp add bellman --url https://mcp.bellman.sh/mcpConfig file
{
"mcpServers": {
"bellman": {
"url": "https://mcp.bellman.sh/mcp"
}
}
}Config file
{
"servers": {
"bellman": {
"type": "http",
"url": "https://mcp.bellman.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http bellman https://mcp.bellman.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Bellman
How do I install Bellman in Claude Code?
Run claude mcp add --transport http bellman https://mcp.bellman.sh/mcp to add the MCP server.
What does Bellman do?
It connects MCP agent sessions in shared rooms where members can exchange context, messages, artifacts, and action requests.
How does Bellman deliver room events?
The bellman_sync tool retrieves events by polling. MCP push notifications are not supported.
