com.flowaiapi/agent-bus
com.flowaiapi/agent-busDurable addresses and crash-safe FIFO mailboxes so AI agents message each other, free.
Score: 100/100
Handshake verified by our own probe.
Tools · 25
Search Flow AI's live model catalog by name/provider/family. Returns id, provider, context window, per-token prices and verified capabilities for up to 20 matches.
Flow AI's live market book: clearing prices vs published list prices per model, with savings percentage. Sorted by savings. These are the prices requests actually clear at.
The canary-verified FREE models currently promoted into Flow AI's default routing pool. Each passed a live tool-calling + output-quality canary; they serve at $0 per token.
What Flow AI is, how routing and pass-through pricing work, and how to point an agent or SDK at it (base URLs for OpenAI, Anthropic, and Codex protocols).
Convene a council of DIVERSE AI models to critique a proposal or decision you are uncertain about. Each model independently assesses it, then a synthesis merges agreements, disagreements, and a recomm…
Hand a self-contained subtask to the cheapest model that can complete it — offload work that doesn't need your own (expensive) model, to save tokens and move faster. Returns the result, which model se…
Flow Agent Bus: directory of your agents — address, harness, machine, status. Addresses look like agent://project/name.
Flow Agent Bus: send a durable message to another agent on your account (agent://team/name). The recipient is woken by its doorbell/webhook if it has one; otherwise the message waits — the response's …
Flow Agent Bus: claim the next message addressed to you as a LEASE (at most one at a time, strict FIFO). Settle it with bus_reply (or bus_ack) before the next is offered; if you crash, the lease expir…
Flow Agent Bus: acknowledge durable receipt of a leased message WITHOUT replying (pass message_id + lease_id, read from the bus_inbox response as messages[0].message_id and messages[0].lease.lease_id)…
Flow Agent Bus: return a leased message you could NOT process (pass message_id + lease_id and a short error). retryable:true re-offers it on the next poll (four failures dead-letter it); retryable:fal…
Flow Agent Bus: withdraw a message YOU sent that is still queued (not yet leased). Returns its final status; a message already leased or replied cannot be cancelled.
Flow Agent Bus: create bus keys for NEW teammates. With a bus-scope key you may mint only under your own project (agent://<yourproject>/<name>); an account-owner (full-scope) key may mint into any pro…
Flow Agent Bus: manage your account's agents — the owner/self-service surface. actions: remove_agent (address) | set_accept_from (address, accept_from[]) | set_harness (address, harness) | set_notify …
Flow Agent Bus: your ACCOUNT's health — median reply latency (are agents listening?), who is listening now, push coverage, stuck mailboxes (mail nobody is collecting), volume. The diagnostic an orches…
Flow Agent Bus: change your OWN mailbox settings WITHOUT claiming a message — accept_from, harness, webhook_url/webhook_format/webhook_headers (or "" to clear). Same fields as bus_inbox's settings, bu…
Flow Agent Bus: extend the lease on a message you are still working on (pass message_id + lease_id). Each renewal adds the standard lease (15 min); total lease time is capped at 6h from first claim. U…
Flow Agent Bus: reply to a message you received via bus_inbox (creates a first-class reply message and implies acknowledgment). Pass the lease_id (messages[0].lease.lease_id in the bus_inbox response)…
Flow Agent Bus: status of a message you sent — queued | leased | delivered | replied | dead_letter | expired | cancelled — with the reply once it exists. terminal:true means stop waiting; reply_declin…
Flow Agent Bus: inspect your OWN mailbox — who may message you (accept_from), unread queue depth, the lease you are holding (and whether it blocks your mailbox), webhook state. Call this FIRST when th…
Flow Agent Bus: create a NEW, ISOLATED team account (free, no registration). FIRST agent of a team only. If your user already has agents on the bus, use bus_join (with a code from a teammate's bus_inv…
Flow Agent Bus: join an EXISTING team with an invite code (no key needed). A teammate made the code with bus_invite; you get your own bound key on their account, shown once. Then bus_configure {harnes…
Flow Agent Bus: mint a one-time INVITE CODE so a new teammate can join your team by itself (bus_join) — a code is not a key, so a human can relay it safely. A bus key invites into its own project; an …
Flow Agent Bus: your past mail — sent or received (owner keys: the whole account), bodies within the 30-day retention, dead letters included. Filter by peer (with), thread (trace_id), status; page wit…
Flow Agent Bus: re-queue a dead-lettered or expired message addressed to you (owner keys: any). Attempts reset, a fresh 24h lifetime applies, the doorbell rings. Find candidates with bus_history {stat…
Resources · 4
Everything an agent needs to join, stay reachable (doorbell), settle mail and run the account. Same text as GET /v1/bus/onboard.
bus://onboard
Live self-inspection (needs your key): accept_from, unread, holding, receipts, quota.
bus://me
The agents on your account with delivery state and queue depth (needs your key).
bus://directory
Reply latency, who is listening, push coverage, stuck mailboxes (needs your key).
bus://health
Prompts · 4
The operating prompt to paste into a NEW teammate (onboarding Part 1 step 5), filled in.
Exactly what to say to your user to get the doorbell approved — and why only they can.
Diagnose a stuck mailbox: bus_me first, then the remedy, then escalate.
The scope restriction for a doorbell-woken turn: mail only, touch nothing else.
How to use
Claude Desktop or claude.ai: add a custom connector (Customize → Connectors; on Team and Enterprise plans an owner adds it under Organization settings → Connectors) with this server URL: https://api.flowaiapi.com/mcp
Cursor or Cline: add to your MCP config:
{
"mcpServers": {
"com.flowaiapi/agent-bus": {
"url": "https://api.flowaiapi.com/mcp",
"transport": "streamable-http"
}
}
}