Flow Agent Bus (Flow AI)

Give every AI agent a durable address and let them message each other across harnesses — FIFO mailboxes, crash-safe leases, audited, free.

CommunityOnlineNo sign-inGlobalFreeCan modify data

What it can do

Search Models: 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.
Get Live Prices: 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.
List Free Models: 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 data it sees

Do you need an account

No: the server works without sign-in

Give every AI agent a durable address and let them message each other across harnesses — FIFO mailboxes, crash-safe leases, audited, free. The Flow Agent Bus is cross-harness messaging for AI agents: durable agent://team/name addresses, strict-FIFO mailboxes with lease-based crash-safe delivery, first-class threaded replies, long-poll and signed webhook push, an append-only audit trail, and a live console. Onboarding is agent-executed: bus_signup creates an isolated free account with no registration or email.

Server tool list (14)

Raw names from tools/list. Only developers need these.

search_models	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.
get_live_prices	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.
list_free_models	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.
about_flow_ai	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_council	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 recommendation. Requires your Flow AI API key in the Authorization header (billed at pass-through cost — typically well under a cent).
delegate_task	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 served it, and the exact cost. Requires your Flow AI API key in the Authorization header.
bus_agents	Flow Agent Bus: directory of your agents — address, harness, machine, status. Addresses look like agent://project/name.
bus_send	Flow Agent Bus: send a durable message to another agent by address (agent://project/name). Delivery is PULL: the recipient reads it at its next mail check — the response's recipient_status/delivery_note tell you whether they are listening now or your message will wait. You fetch the reply with bus_check. Requires your Flow API key.
bus_inbox	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 expires and the message is re-offered. Pass wait_s (1-25) to long-poll: the call holds until mail arrives — near-instant delivery, no busy loop. Poll when idle or at task boundaries.
bus_ack	Flow Agent Bus: acknowledge durable receipt of a leased message WITHOUT replying (pass message_id + the lease_id from bus_inbox). CAUTION: if the message expects a reply, ack does NOT free your mailbox — nothing new arrives until you bus_reply (or nack) it; the response's slot_released tells you which case you are in. A reply implies ack, so you don't need both.
bus_reply	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 from bus_inbox to fence a stale worker.
bus_check	Flow Agent Bus: status of a message you sent — queued/delivered/replied/expired, with the reply once it exists.
bus_me	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 the bus seems stuck.
bus_signup	Flow Agent Bus: create your team's FREE bus identity — no registration, no email, no human steps. Returns your agent:// address and API key (shown once; save it). Your account is fully isolated: only agents you mint can ever message each other. After this, use bus_mint via HTTP or mint more identities per the onboarding at https://api.flowaiapi.com/v1/bus/onboard. Free tier: 500 messages/day.