Skip to main content
Glama
jaimenbell

bus-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BUS_MCP_LIVENoSet to 1 to run the real-network smoke test
BUS_MCP_BASE_URLNoBase URL of the coordination bushttp://127.0.0.1:8100/api/bus
BUS_WRITE_SECRETNoSame var the bus itself reads to arm write-auth (v1.1). When set here, every write tool call sends X-Bus-Secret: <value> automatically.
BUS_MCP_TIMEOUT_SNoPer-request timeout (seconds)10.0

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
post_messageA

Append one message to the coordination-bus blackboard (append-only). v1 stores action_flag but performs no action -- it is display-only, seen by a human watching the command-center panel.

read_messagesA

Recent bus messages, newest first, optionally filtered by topic.

claim_laneA

Claim a coordination lane before starting work in it: claim-if-free, steal-if-lease-expired, renew-if-you-already-own-it. A 409 (lane held live by another owner) comes back as a clean ok=False conflict, not a crash. The bus may grant a shorter lease than requested (server-side ceiling, coordination-bus v1.3+): on ok=True the response's top-level lease_s is the EFFECTIVE (post-clamp) duration actually granted -- always check it rather than assuming the requested value was honored. See get_bus_status's _meta.max_lease_seconds for the currently configured ceiling. Older bus servers (pre-v1.3) omit lease_s from the response entirely; its absence just means the bus predates the ceiling feature, not an error.

release_laneB

Release a coordination lane you hold. A 409 (held live by another owner) comes back as a clean ok=False conflict, not a crash.

heartbeat_laneA

Renew the lease on a coordination lane you hold live. A 409 (not held live by you) tells you to (re)claim instead of crashing. Like claim_lane, renewal is subject to the same server-side lease ceiling (coordination-bus v1.3+): on ok=True the response's top-level lease_s is the EFFECTIVE (post-clamp) duration actually granted, which may be shorter than requested -- check it rather than assuming the request was honored in full. See get_bus_status's _meta.max_lease_seconds for the currently configured ceiling. Older bus servers (pre-v1.3) omit lease_s from the response entirely; its absence just means the bus predates the ceiling feature, not an error.

get_bus_statusA

Roll-up for the command-center panel: active lanes, orphaned/stale claims, recent messages, pending display-only action flags. Also exposes _meta.max_lease_seconds (coordination-bus v1.3+): the currently configured lease ceiling that claim_lane/heartbeat_lane requests get silently clamped to. Check this before claiming a lane for longer than the default if you need to know whether the request will actually be honored in full. Older bus servers (pre-v1.3) omit max_lease_seconds from _meta entirely; its absence just means the bus predates the ceiling feature, not an error.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jaimenbell/bus-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server