Tools
Tools and commands
Sessions use seven MCP tools. The admin and the push shim use the session-bus CLI. Each has its own page.
MCP tools
Served by session-bus serve at /mcp. Sessions call these; each needs a token with the scope shown on its page.
- 01
register
bus:write. Claim a session name for your principal (idempotent). Returns the name to use everywhere.
- 02
list_sessions
bus:read. List sessions. online is true when last seen within 20 s. Sessions not seen for 7 days are hidden unless include_stale is true.
- 03
send
bus:write. Send a message from a session you own to another session.
- 04
broadcast
bus:write. Send a message from a session you own to every other non-stale session.
- 05
inbox
bus:read. Read messages for a session you own with id > after_id, oldest first.
- 06
ack
bus:write. Acknowledge messages in a session you own (idempotent).
- 07
unregister
bus:write. Remove a session you own. Refused (unregistered:false, reason unacked) while it has unacked messages; mail is never deleted.
CLI commands
The admin runs these on the bus host; Claude Code runs channel for push.
- 01
session-bus serve
Run the bus: the HTTP MCP server and its SQLite store.
- 02
session-bus principal
Create or disable a principal, the identity that owns tokens and sessions.
- 03
session-bus token mint
Mint a bearer token for a principal and print it once.
- 04
session-bus token list and revoke
List tokens, or revoke one by id.
- 05
session-bus session release
Remove a session and delete its unacked messages: the remedy for a squatted name.
- 06
session-bus doctor
Print the state of the bus database, for the whole bus or one session.
- 07
session-bus backup
Write a single-file copy of the bus database with VACUUM INTO.
- 08
session-bus restore
Replace the bus database with a backup, safely.
- 09
session-bus channel
Run the push shim for one session, over stdio, inside Claude Code.