Developer Platform
Build on Cryptographic Mandates.
Control execution before it happens. Every action is evaluated, authorized, and verified before it runs.
const result = await yebo.authorize({ ... })
Install the SDK: npm i @yebo-auth/sdk Full SDK reference available under sandbox access.
Request Sandbox Access →SDKs
The TypeScript SDK (@yebo-auth/sdk 1.1.0) is on npm. Python, Swift, Rust and Go are coming soon.
The Authorization Pipeline
An intent request runs these stages in order: policy first, then the mandate, approval if required, execution (dry run) and the receipt. Sentinel invariants run on the separate /execute path. Payment missions are checked by the gateway's mission gate: scope, amount, payee, expiry and a passkey approval.
- INTENTAgent or user submits an action via API: what they want to do, with what constraints.→
- POLICYThe policy engine returns ALLOW, DENY or REQUIRE_APPROVAL against your rules, limits, and allowlists, and fails closed. A denied action stops here and is logged.→
- MANDATEAn allowed or held action is formalized into an immutable mandate: sealed, time-limited, and single-use.→
- APPROVALIf required, a human approves. For payment missions, the passkey approves the mission's limits. Per-payment device signing is live and has been exercised in production: the approver's passkey signs the exact payment (amount, payee, agent, validity window), and anyone can check it offline with yebo-verify 0.2.0.→
- EXECUTERuns in dry-run mode today: Yebo issues a signed dry-run receipt and no money moves. Live payment execution is coming soon.→
- RECEIPTA gateway-signed receipt (ECDSA P-256) is generated and stored, checkable against the published public keys with the open-source npm verifier, npx yebo-verify@0.2.0.
What the API does
A small number of capabilities cover every integration: submit actions, preview decisions, approve pending requests, and retrieve verifiable records. Full endpoint reference, payload shapes, and authentication details are available under sandbox access.
Send an action through the pipeline. Yebo returns a sealed mandate and a decision.
Check whether an action would be allowed without triggering execution.
Confirm an authorization is still valid: policy compliance, expiry, replay protection.
A human approves pending requests. For payment missions, the passkey approves the mission's limits (capabilities, per-transaction limit, payees). Per-payment device signing is live and has been exercised in production: the approver's passkey signs the exact payment (amount, payee, agent, validity window), and anyone can check it offline with yebo-verify 0.2.0.
Pull the verifiable authorization record: what was requested, who approved it, what policy applied.
Package a gateway-signed evidence bundle for auditors or compliance teams. Bundles verify offline with npx yebo-verify@0.2.0 bundle.
The Mandate
Every action is converted into a mandate, the core authorization primitive. A mandate defines the action, the scope, and the governing policy. Mandates are immutable once created, time-limited, and single-use. Any change requires a new mandate.
Sealed on creation
Short expiry window
Cannot be replayed
Decision Model
Yebo returns one of three outcomes for every action:
Action proceeds (payments run as dry run today).
Action pauses until approved.
Action is blocked and never executes.
Verification
Before execution, Yebo verifies that the action matches the approved mandate, the authorization is valid, the request has not expired, and the request has not been replayed. If any check fails, execution is blocked and a clear reason is returned.
Yebo MCP Server
Add the Yebo MCP server to Claude Desktop, Cursor, or any MCP-compatible AI tool with one config block (partner preview: its authorization tools are being updated to the current gateway API).
The MCP server installs with a single config block in Claude Desktop or Cursor and exposes a focused set of authorization tools: preflight a decision, request approval, verify, and pull a mandate. Config snippets, package name, tool surface, and API-key format are available to approved partners under sandbox access.
Request Sandbox Access →Identity setup
One interactive command creates your Yebo identity and generates your config, with a software key on your machine.
The CLI walks you through naming your identity and picking a handle. Binding a device key through the Yebo iOS app is coming soon. The exact command, generated identifiers, config paths, and gateway endpoints are available to approved partners under sandbox access.
Request Sandbox Access →Yebo does not replace your systems.
It controls what they are allowed to execute.
For actions routed through the gateway: if an action cannot be verified, it does not run.