Every route Wire exposes.

Turns one plain-English request into a live Flow page — single price, multiple named tiers, or a recurring subscription, decided automatically from the wording. Pass "Authorization: Bearer <your dev key>" to create it under your own account instead of anonymously; omit it and the page is unowned until someone logged-in claims it by viewing its dashboard.

{
  "slug": "a1b2c3d4",
  "checkoutUrl": "/checkout/a1b2c3d4",
  "dashboardUrl": "/dashboard/a1b2c3d4",
  "record": { "apiKey": "flow_...", "...": "see FlowRecord" }
}

Every Flow page the logged-in user owns. Also sweeps in and claims any unowned page created from this same browser first.

{
  "email": "you@example.com",
  "flows": [ /* FlowRecord[] */ ]
}

Polled every 3s by the dashboard. With a browser session, claims an unowned page for the current viewer on first load and 403s if it's already owned by someone else. With "Authorization: Bearer <the Flow's own apiKey>" (returned when it was created, not your developer key) it skips ownership entirely — this is the status-check path for a third-party app.

// FlowRecord, plus subscriberCount if the Flow is recurring
{ "...": "see FlowRecord", "subscriberCount": 4 }

Tiered Flows only. Creates a one-off invoice for the chosen tier's price — there's no single fixed checkout link when a page has tiers.

{ "checkoutUrl": "https://checkout.paystack.com/..." }

A standalone PNG QR code pointing at the Flow's checkout page — used to hand WhatsApp a public image URL, but works for anything that needs the raw image.

// image/png bytes, not JSON

The full bank list for the payout-setup dropdown.

{ "banks": [ { "name": "GTBank", "code": "058" }, ... ] }

The logged-in user's payout account, if they've set one up.

{ "account": /* PayoutAccount */ null }

Creates a Paystack subaccount for this user (once) and saves it. Defaults to a 100% split — the seller keeps everything unless a platform fee is set explicitly.

{ "account": /* PayoutAccount */ }

Parses a curl command or OpenAPI JSON spec into a gateway and registers it, ready to be pointed at by /api/gateway/{id}/mcp.

{
  "id": "gw_x1y2",
  "sourceLabel": "curl: api.example.com",
  "baseUrl": "https://api.example.com",
  "auth": { "type": "bearer" },
  "operations": [ /* GatewayOperation[] */ ]
}

The live MCP server for a generated gateway — point any MCP-capable client at this URL. Stateless: re-compiled from the stored spec on every request.

// Streamable HTTP MCP transport, not a plain JSON body

A downloadable MCP client config file (mcpServers block) pointing at the gateway above.

{ "mcpServers": { "wire-gateway-gw_x1y2": { "url": "...", "description": "..." } } }

The fixed Paystack-preset MCP server — six tools (invoice, reserved account, sub-account split, refund, wallet balance, transaction search).

// Streamable HTTP MCP transport

Downloadable MCP client config for the Paystack preset above.

{ "mcpServers": { "wire-paystack": { "url": "...", "description": "..." } } }

The Playground's live test chat — streams Server-Sent Events as the agent reasons, calls tools, and gets results back, against either the Paystack preset or a generated gateway.

// text/event-stream — events: reasoning, tool_call, tool_result, error, done
event: tool_call
data: {"tool":"get_wallet_balance","input":{}}

event: tool_result
data: {"tool":"get_wallet_balance","output":{...},"isError":false}

Creates an account and starts a session.

{ "email": "you@example.com" }

Verifies credentials and starts a session.

{ "email": "you@example.com" }

Ends the current session and clears the cookie.

{ "loggedOut": true }

Who's currently logged in.

{ "email": "you@example.com" }

Your developer API key — creates one on first request, returns the same one on every call after that. This is what you put in your own backend's config; pass it as "Authorization: Bearer <key>" on POST /api/flow to create Flow pages under your account without a browser session. Distinct from a single Flow's own apiKey (returned when that Flow is created), which only ever authenticates GET requests for that one Flow's status.

{ "apiKey": "dev_..." }

Saves the link between a sellerId (browser cookie) and a gateway they've connected.

// SellerRecord
{ "sellerId": "...", "gatewayId": "...", "sourceLabel": "...", "connectedAt": "..." }

Looks up what a given sellerId has connected, if anything.

// SellerRecord

Paystack's charge.success notifications. Verifies x-paystack-signature (HMAC-SHA512 over the raw body, keyed with the secret key), records the sale, captures a reusable authorization for recurring billing, and fans out to any connected system.

{ "received": true }

Inbound WhatsApp messages via Twilio. Verifies X-Twilio-Signature, then runs the same Flow-creation agent a browser request would, replying over WhatsApp.

// 200 with an empty body in every case Twilio should not retry

Fired daily by Vercel Cron (see vercel.json). Charges every recurring subscription whose next cycle is due, via Paystack's charge-authorization API.

{ "charged": 3, "results": [ { "id": "...", "ok": true }, ... ] }