Bus MCP server
MCP server fronting a self-hosted coordination-bus HTTP API: post/read/claim/release/heartbeat.
0 stars43 downloads/wk
Reviews
Write oneNobody has reviewed Bus yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Bus tools (7, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
_error_payloadclaim_laneget_bus_statusheartbeat_lanepost_messagewrite actionread_messagesRecent bus messages, newest first, optionally filtered by topic.
release_lane
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan7 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 9 days ago15/15
- Maintainer identityregistry namespace matches repository owner6/10
How Bus compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 89/100
- higher than 80% of 48,273 servers
- Tools
- 7
- the typical server has 7
- Tools that change things
- 14%
- typical: 0%. Fewer write tools means less an agent can break
- Downloads a week
- 43
- more than 36% of 11,915 servers with a package
What its tools let an agent do: 6 read · 1 send or post
Install Bus in Claude Code, Cursor or VS Code
claude mcp add bus-mcp -- uvx bus-mcp
What the publisher says
From the Bus repository's README, as published. We do not edit it. Read it on GitHub
bus-mcp
An ergonomic MCP server fronting the self-hosted AlphaHive coordination bus (backend/coordinationbus.py in the alphahive repo) -- so a Claude agent calls claimlane("feeds-refactor", owner="session-A") instead of hand-rolling curl -X POST .../lanes/feeds-refactor/claim -d '{...}'. Built to the desktop-mcp/github-mcp standard (own pyproject, fastmcp server, honest README, real test suite) -- this is that exact "MCP over an HTTP API" pattern turned on our own self-hosted API.
Quickstart (60 seconds)
pip install bus-mcpAdd to your Claude Desktop/Code MCP config:
{
"mcpServers": {
"bus-mcp": {
"command": "bus-mcp"
}
}
}No console script on PATH? Fall back to "command": "python", "args": ["-m", "bus_mcp"]. By default this talks to a bus at http://127.0.0.1:8100/api/bus -- see "Env vars" below to point it elsewhere.
What this is / is not
This fronts a private, localhost-only, no-auth v1 coordination substrate -- not a public service. The bus itself is a blackboard (append-only messages) + a lane-claim registry (task-queue leases with steal-on-expiry) + a status rollup for a command-center panel. It executes nothing outward-facing: action_flag on a message is recorded and displayed only, never acted on by the bus. bus-mcp adds zero new capability over what the bus already does via curl -- it only makes the routes ergonomic MCP tools with typed inputs and typed errors instead of raw HTTP. It deliberately wraps LESS than the bus offers: see "What this will never wrap" below.
Tools
24 tools. Writes are gated (BUSMCPENABLE_WRITE); reads never are.
Messages and lanes
Threads -- topics are the broadcast log; threads are how two agents (or an agent and a human) hold one conversation with a beginning and an end.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Bus: common questions
- Is Bus MCP server safe?
- Yes, by our scan: it is graded A (89/100). Read the Bus safety report
- How do I install Bus?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Bus need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Bus maintained?
- The last commit was 48 days ago (2026-09-15). The latest release is v0.1.1.
- How does Bus compare with other MCP servers?
- safety score 89/100 (higher than 80% of 48,273 servers); tools 7 (the typical server has 7); tools that change things 14% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.