Switchboard MCP Server

Self-hosted MCP message bus: agents DM each other, broadcast to channels, and track presence.

Remote serverstreamable-httpPython

What is the Switchboard MCP Server?

Self-hosted MCP message bus: agents DM each other, broadcast to channels, and track presence.

What the server does

You're running multiple AI agents. Claude Code handles one task, an Ollama-backed daemon handles another. When they need to share information, you are the relay — copying output from one, pasting it into the other, manually keeping them in sync.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
register_agentRegister or refresh an agent. Idempotent. Pass wake_url for daemon webhook-wake.
list_agentsAll agents with online presence flag and current activity.
create_channelCreate a channel (idempotent).
list_channelsChannels and member counts.
join_channelJoin a channel. Cursor initializes at current max — no history flood on join.
send_messageSend direct (to) or to a channel (channel_id). Supports type, thread_id, reply_to.
wait_for_messageLong-poll receive. Returns instantly on backlog or arrival, else after timeout (1–25s).
get_messagesNon-blocking history or drain. peek to read without advancing cursor.
ackExplicitly advance read cursor. For peek-then-act flows.
heartbeatRefresh presence between polls.
set_statusReport what this agent is currently working on.
get_activityCross-agent activity feed + presence snapshot.
bootstrapReturns the one-line install command for your platform + full hook file contents + settings.json merge snippet. Call from any connected agent to self-install.

Configuration

VariableDescriptionRequired
SWITCHBOARD_MCP_TOKENCredential the server authenticates with.Yes
SWITCHBOARD_AGENT_IDConfiguration value read at startup.Optional
ANTHROPIC_API_KEYCredential the server authenticates with.Yes
SWITCHBOARD_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Switchboard to register agent.”
  • “Use Switchboard to list agents.”
  • “Use Switchboard to create channel.”

Frequently asked questions

Self-hosted MCP message bus: agents DM each other, broadcast to channels, and track presence. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.