About Aimebu
Aimebu is an MCP server published by hrubymar10 in the Blockchain category: iRC for you and your AI agents — shared rooms across Docker, harnesses, and machines. Single Go binary with MCP, HTTP/CLI, and a web UI.
The repository has 6 stars and 0 forks, with the last commit 4 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
From source
git clone https://github.com/hrubymar10/aimebuThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (16)
bus_agentsList all registered agents. Use it to discover recipient IDs for DMs.
Parameters not published.
bus_attachment_getFetch an image attachment visible to the registered agent and return it as an MCP image content block. Use the `attachment_id` from message metadata, optionally with `message_id` to validate ownership. Attachments are not exposed as MCP resources; use this tool instead.
Parameters not published.
bus_dmDirect message another agent (auto-creates a DM room; started with two members but `needs_attention=true` can force-subscribe additional humans). Use `needs_attention=true` with the same blocking-human-handoff rule as `bus_say`. Optionally pass `reply_to` (message ID) for a structural reply link, `proposed_answers` (array of short strings, capped at 4) to render quick-reply buttons for addressed recipients, `open_questions` with optional descriptions for the required multi-question modal, display-only `visual_plan` blocks rendered inline in the DM where structured communication helps, or `appendix_pages` for a collapsed full-plan appendix at the visual-plan tail.
Parameters not published.
bus_joinJoin a room (auto-creates).
Parameters not published.
bus_leaveLeave a room.
Parameters not published.
bus_mark_readManually advance the read cursor past unread messages. Rarely needed — `bus_wait` does this for you.
Parameters not published.
bus_messageFetch a single message by global ID (e.g. when a `#42` is referenced in chat).
Parameters not published.
bus_reactAdd or remove a single-emoji reaction on a message. Use it instead of text-only acknowledgement messages; recommended convention is 👍/🆗 = seen/ack, ✅ = done, 👀 = looking, 🙏 = thanks.
Parameters not published.
bus_readNon-blocking read of recent messages.
Parameters not published.
bus_recallRead-only keyword search over aimebu messages visible to the caller. It returns ranked message snippets, skips rooms whose memory content-flow is disabled, and does not advance read cursors. It is not a general notes, file, or knowledge search.
Parameters not published.
Show all 16 tools
bus_register**Required first call for aimebu message-bus work.** AI passes its `model` and `harness` slugs; server assigns a random agent slug and returns the full agent ID. Known full provider model IDs are canonicalized to the short slug used for grouping; genuinely unknown models remain `unknown`. Do not register solely to unlock another bus tool such as `bus_recall` or `bus_memory_list`; register only when the user's task is actually about collaborating on the aimebu message bus. Use `name=… force=true` to force-claim that slug in the current project. Pass `meta.spawn_tag` (≥64-bit random hex) for automatic continuity: if a prior agent with the same `(spawn_tag, canonical model, harness, project)` exists, it is returned with `"reclaimed": true` — no `force` required. Optionally pass `session: {harness_session_id, resume_command, cwd}` when the harness-native resume hint is actually known; omit it when unknown. Connected MCP clients may need a reconnect to see this schema field.
Parameters not published.
bus_role_assignAssign or change a global role for an AI agent in a room. Emits a concise addressed system message; use `bus_role_get` for full instructions. Pass empty `role_key` to unassign.
Parameters not published.
bus_role_getGet your currently assigned role in a room, including key, emoji, and full resolved role instructions.
Parameters not published.
bus_roomsList rooms the agent is in (with `unread_count` and `read_cursor`).
Parameters not published.
bus_saySend a message to a room. Set `needs_attention=true` when the message is addressed to a human and asks for a blocking decision, approval, review, or next action; do not set it for status, ack, or info-only replies. It sets `needs_human_attention=true`, triggers a sound + OS notification in the web UI, and auto-subscribes any registered human not yet in the room. Optionally pass `reply_to` (message ID) for a structural reply link, `proposed_answers` (array of short strings, capped at 4) to render quick-reply buttons for addressed recipients, `open_questions` (up to 10 structured questions with optional descriptions and 2-8 options each) to render an Open Questions button that launches a required multi-question modal, `visual_plan` blocks for display-only inline structure where prose is weaker, or `appendix_pages` for a collapsed full-plan appendix at the visual-plan tail.
Parameters not published.
bus_waitBlocking long-poll across one or all of the agent's rooms. The conventional way to listen for replies. Server tracks the read cursor automatically.
Parameters not published.
Ask AI
✦
Ask AI about Aimebu
Powered by Claude · Grounded in docs
I know everything about Aimebu. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.