Claude Bridge
Extends Claude Code's agent teams across different machines using a relay server over HTTP and Server-Sent Events. Install the bridge on one host, point each Claude Code session at it via SSE transport, and agents get six tools: bridge_send, bridge_receive, bridge_channels, bridge_ping, bridge_clear, and bridge_status. Messages route through named channels with incremental polling via since_id cursors. Works over localhost for single-machine setups, LAN IPs for local networks, or Tailscale/mesh VPNs when your orchestrator and workers live on completely separate networks. Includes a web dashboard and optional stdio mode for subprocess spawning without HTTP overhead.
- GitHub stars
- 14
- tools
- 13
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Aug 23, 2026
Tools
13 toolsPublic tool metadata for what this MCP can expose to an agent.
bridge_sendSend legacy text or a protocol-v1 message; supports idempotent retries
Send legacy text or a protocol-v1 message; supports idempotent retries
No parameter schema in public metadata yet.
bridge_receiveRead a bounded page using a message cursor or durable consumer cursor
Read a bounded page using a message cursor or durable consumer cursor
No parameter schema in public metadata yet.
bridge_waitWait up to 55 seconds for new messages without rapid polling
Wait up to 55 seconds for new messages without rapid polling
No parameter schema in public metadata yet.
bridge_ackMonotonically advance a consumer's channel-scoped cursor
Monotonically advance a consumer's channel-scoped cursor
No parameter schema in public metadata yet.
bridge_channelsList active channels and counts
List active channels and counts
No parameter schema in public metadata yet.
bridge_pingCheck bridge health and capabilities
Check bridge health and capabilities
No parameter schema in public metadata yet.
bridge_statusSummarize recent activity across channels
Summarize recent activity across channels
No parameter schema in public metadata yet.
bridge_clearDelete every message (and task) in one channel
Delete every message (and task) in one channel
No parameter schema in public metadata yet.
bridge_enqueueAdd a task to a channel's work queue (exclusive; claimed once)
Add a task to a channel's work queue (exclusive; claimed once)
No parameter schema in public metadata yet.
bridge_claimAtomically claim the next task with a lease; long-poll with `wait_seconds`
Atomically claim the next task with a lease; long-poll with `wait_seconds`
No parameter schema in public metadata yet.
bridge_completeMark a claimed task done, fenced by its `lease_token`
Mark a claimed task done, fenced by its `lease_token`
No parameter schema in public metadata yet.
bridge_failFail a claimed task — requeue with backoff, or dead-letter
Fail a claimed task — requeue with backoff, or dead-letter
No parameter schema in public metadata yet.
bridge_tasksInspect a channel's queue: per-status counts and a task list
Inspect a channel's queue: per-status counts and a task list
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
CLAUDE_BRIDGE_DBSQLite database path (default: ./claude-bridge.db). Share the same path across HTTP and stdio instances to share state.
CLAUDE_BRIDGE_AUTH_TOKENsecretOptional Bearer token for HTTP mode. As of 1.2.0, binding a non-loopback host requires this token together with an explicit trusted host (CLAUDE_BRIDGE_TRUSTED_HOSTS), unless --allow-unauthenticated-network is passed; loopback (stdio and localhost) does not require it. When set,
Readme
Claude Bridge
A local-first, cross-machine message bus for independent coding agents.
Claude Bridge lets coding-agent sessions on different machines exchange ordered messages through named channels. The relay is self-hosted, uses SQLite by default, and exposes MCP, a small JSON API, a dashboard, and a terminal UI.
It does not call a model API and does not require agents to share a filesystem or process. Claude Code motivated the project, but the core is MCP-based and is not coupled to Anthropic.
Details
- Repository
- github.com/constripacity/claude-bridge
- Package
claude-code-bridge- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active