Waitbus
Workstation-local event bus: agents wait on or emit CI/pytest/Docker/filesystem events, no polling.
Connector by astrogilda · GitHub account verified by the MCP Registry
Install
Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/astrogilda-waitbus
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.
- Tools
- 4 read · 1 write · 0 delete
- Secrets
- None asked for
- Install scripts
- None found
- Runs as
- Python package
Tools by what they do 5
Read from the source code; the running server may list different tools.
Read 4 · Look things up without changing anything.
get_eventquery_ciread_agent_messagestail_events
Write 1 · Create, change, send or run things.
emit_agent_message
Network hosts it talks to 13
api.github.com· found in codeapi.openai.com· found in codeastral.sh· found in codecode.claude.com· found in codecontext7.com· found in codeelixir.bootlin.com· found in codeget.docker.com· found in codegithub.com· found in codejson.schemastore.org· found in codeman.freebsd.org· found in codeno-color.org· found in coderaw.githubusercontent.com· found in codezenodo.org· found in code
Files it touches
~/.ssh/known_hosts/proc/cpuinfo/proc/self/schedstat/proc/stat/proc/sys/kernel/randomize_va_space/root/waitbus/fidelity-done.exit-code/root/waitbus/fidelity-out/root/waitbus/fidelity-run.log/root/waitbus/soak-done.exit-code/root/waitbus/soak-verdict.json/root/waitbus/soak-verdict.json.progress.jsonl/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor/sys/devices/system/node/var/run/docker.sock- Your home directory (~)
~/.config/systemd/user~/.config/waitbus~/.config/waitbus/config.toml~/.local/share/systemd/user~/.local/state~/.local/state/waitbus~/Library/LaunchAgents~/Library/Preferences/waitbus
Tools (5)
Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].
emit_agent_messageSend agent messageSend one agent-to-agent message addressed to an agent name (or '*' to broadcast). ONLY for agent-to-agent coordination messages addressed by agent name; NEVER for querying CI status, jobs, pull requests, or events -- use query_ci or tail_events for that. Hardcodes event_type=agent_message so the message rides the typed lane, never the CI stream.
get_eventGet eventread-onlyFetch one stored event row by its opaque ULID, including the fenced raw webhook payload. Tool-surface parity for the waitbus://event/{ulid} resource. Oversize payloads return a truncation marker with a raw_uri pointer to the uncapped waitbus://event/{ulid}/raw resource.
query_ciQuery CIread-onlyQuery CI state in one of three views selected by the required 'view' enum: 'status' (latest workflow_run per repo), 'failed_jobs' (recent failing workflow_job rows), or 'pr_aggregate' (every run and job for one pull request; requires repo and pr_number). Pure read of the events DB.
read_agent_messagesRead agent messagesread-onlyCursor-paginated read of agent-to-agent messages addressed to this agent (or to '*'). ONLY for reading messages other agents sent you by name; NEVER for querying CI status or events -- use query_ci or tail_events for that. Returns messages plus next_cursor; nothing re-delivers history. The pull side of the agent doorbell.
tail_eventsTail eventsread-onlyOne-shot windowed read of events above an opaque cursor. Returns events plus next_cursor. max_wait_seconds is capped at 270s to stay below Cursor's 5-minute cancel. agent_message rows are excluded unless event_types explicitly requests them.
Signals
- Stars
- 2
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 38
- Last commit
- Oct 2, 2026 (26 days ago)
- Last release
- Jun 24, 2026 (4 months ago)
- Last package publish
- Jun 24, 2026 (4 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.astrogilda/waitbus- Version
- 0.2.0
- Auth
- No auth
- Packages
- pypi waitbus
- License
- MIT
- Repository
- github.com/astrogilda/waitbus
- First seen
- Oct 24, 2026
- Last checked
- Oct 25, 2026
More from astrogilda
Cite this page
Waitbus MCP server. Agent Mart. https://agentmart.dev/connectors/astrogilda-waitbus (last updated 2026-10-25)