API

Two on-ramps. One credit wallet.

Ounie accounts hit the REST endpoints with a bearer token. AI assistants — including the Ounie AI Team — connect over MCP and get a native tool surface. Both run the same generation pipeline and draw your shared Ounie credits (1 credit = 1¢), never overdrawing. Drafting is grounded in your own private brain, so there is no keyless x402 rail — agent access is API keys and MCP.

MCP · for AI assistants and the Ounie AI Team

Streamable HTTP at /api/mcp (legacy SSE at /api/sse). Auth with an atb_live_… key from your dashboard, or the Ounie fleet master key ounie_live_… (needed to ground in your brains).

Endpoint  https://ai-team.ounie.com/api/mcp
Header    Authorization: Bearer atb_live_…

# If your MCP client can't set headers, append the key as a query param:
https://ai-team.ounie.com/api/mcp?api_key=atb_live_…

Tool	What it does	Cost
generate_blueprint	Draft an AI Team blueprint from a business URL and/or your brains.	5 credits
list_blueprints	List the blueprints you've drafted.	free
get_blueprint	Full artifact by id — plays, org chart, goals, routines, tasks.	free
export_blueprint	Team-package URL + a copy-paste build task for a Team workspace.	free
get_credit_balance	Spendable Ounie credits + how many blueprints that buys.	free
get_pricing	Per-action pricing. No auth required.	public
whoami	The authenticated key's owner + whether it can ground in your brains.	free

Ounie AI Team connection: add an HTTP MCP server with URL https://ai-team.ounie.com/api/mcp?api_key=atb_live_… — the key rides the URL because the AI Team's manual MCP entries can't set headers.

REST · the same endpoints the dashboard uses

Send Authorization: Bearer atb_live_… (or ?api_key=) on any of these. Cookie sessions work too — it's the same route.

POST/api/proposals— Draft a blueprint

{ "url": "https://acme.com", "brain_ids": [], "focus": "" }

Bills 5 credits on success. A URL alone drafts from the public site (any key). Pass brain_ids to ground + cite your brains — that needs a cookie session OR the Ounie master key (ounie_live_); a per-app atb_live_ key with brain_ids gets a 403 with a use-your-master-key message. A corpus too thin to write a real blueprint → 422, not charged.

GET/api/proposals— List your blueprints

Free. Returns { proposals: [...] }.

GET/api/proposals/{id}— One blueprint (full artifact)

Free. Returns { proposal }.

GET/api/proposals/{id}/package— Team-package zip

Free. An importable company package for a Team workspace (Org Chart → Import).

DELETE/api/proposals/{id}— Delete a blueprint

Free. The share page dies with it.

GET/api/brains— Your Ounie brains

For picking brain_ids. Needs a cookie session or the master key — a per-app key can't reach your brains.

Public share reads · no key

A blueprint's unguessable share_slug is the capability — these need no auth (already-paid-for work).

GET/api/p/{slug}/blueprint— Public blueprint JSON

The team, plays, and business — CORS-open, noindex.

GET/api/p/{slug}/package— Public Team-package zip

The importable company package for a Team workspace.

Shape of a generated blueprint

{
  "ok": true,
  "proposal_id": "…",
  "share_slug": "k3v9q2m8x4tz",
  "business_name": "Acme Co",
  "agents": 7,
  "thin_context": false,
  "credits_spent": 5
}

# GET /api/proposals/{id} → { proposal: { artifact: {
#   business: { name, summary, category },
#   plays:    [{ kind: "save|ask|act", title, how,
#                sourceSlug?, sourceBrainId?, sourceTitle? }],  // cited only when grounded
#   team:     { agents:[{ name, role, title, icon, capabilities, reportsTo }],
#               goals, routines, firstWeek }
# } } }