# Bubblio — the door for agents (and the humans who send them)
# https://bubblio.dev

Bubblio puts a door on a product that AI agents can find, knock on, and walk
through — with their human's one-tap blessing, and payment on the platform's
own Stripe. The same install answers human customers by chat widget and email.

## Integrating a platform? One file has everything.
https://bubblio.dev/llms-full.txt
  The whole integration in plain text: the four reference files verbatim, the
  quote→confirm contract, payments, consent, mandates, keys, the SDK API, and
  the endpoint reference. Read that one URL and build without guessing.

## One connector for every door (the hub)
MCP:       https://api.bubblio.dev/agent/hub/mcp   (stateless JSON — POST one JSON-RPC message per request)
Manifest:  https://api.bubblio.dev/agent/hub
llms.txt:  https://api.bubblio.dev/agent/hub/llms.txt

The hub speaks about/ask/list_actions/quote/confirm with the door picked by
argument (door: "<handle or door id>"), plus find { query } to search the
live directory. A door reached through the hub behaves exactly as its own MCP
endpoint would — same keys, approvals, prices, rate caps. Routing, never a
bypass.

## Per-door endpoints
Manifest:  https://api.bubblio.dev/agent/<door_id>
MCP:       https://api.bubblio.dev/agent/<door_id>/mcp
llms.txt:  https://api.bubblio.dev/agent/<door_id>/llms.txt

The bare knock (no MCP client, no handshake):
curl -X POST https://api.bubblio.dev/agent/<door_id>/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"about","arguments":{}}}'

Every door serves about + ask (free, anonymous, rate-capped; answers grounded
in the platform's own knowledge with cited sources). Doors with visible
actions add list_actions, quote, confirm: a quote pins the exact tool + args
(and price) for 10 minutes — 30 while a human approval or a payment link is
in the loop; confirm executes exactly once; a duplicate confirm replays the
original receipt. Some actions need an agent key (bak_…) minted by a
signed-in user on that platform; some need the human's one-tap phone
approval, relayed by the agent.

## Directory of open doors
JSON:  https://api.bubblio.dev/agent/directory
HTML:  https://bubblio.dev/agents
Feed:  https://api.bubblio.dev/agent/feed.json   (ACP-compatible product rows —
       one per listed door action, prices included — for crawlers without MCP;
       transacting still happens on MCP quote → confirm)

## Docs
https://bubblio.dev/docs               (index)
https://bubblio.dev/docs/quickstart    (zero to open door, ~10 minutes)
https://bubblio.dev/docs/agents        (written to visiting agents: etiquette, the price promise)
https://bubblio.dev/docs/security      (identities, leak costs, fail-open vs fail-closed)
https://bubblio.dev/docs/api           (endpoint reference)
https://bubblio.dev/docs/openapi.yaml  (OpenAPI 3.1, served verbatim)

## Pricing (beta)
- Free door: the agent door, questions tier — capped, receipted, listed.
- Teammate: $29/month flat (beta). Chat widget + email + full door (actions,
  payments, mandates). Fair use ~500 VISITOR conversations/month; agent-door
  traffic is not counted during beta. Past fair use the owner gets an email —
  nothing shuts off. Bubblio takes no cut of door payments.

Access is by request (private beta): https://bubblio.dev/signup