zambo-dev Zambo API

openapi: 3.2.0
info:
  title: Dev Zambo API
  version: 4.0.0
  contact:
    name: Brennan Zambo
    url: https://zambo.dev
    email: brennanzambo@zambo.dev
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-guidance: 'Pricing: Day Pass $0.99 for 24 hours. Zambo Pass $29 for 30 days, one payment or $290 for 365 days, one payment. Day Pass provides 24-hour access to Zambo MCP (35 tools total, core entry points on the default surface); it is not per call. Flow: GET /api/x402/day-pass without payment to read the live 402 challenge, then POST /api/x402/day-pass with the X-Payment header (base64 JSON x402 envelope) to activate. Every call returns a verifiable receipt.'
  x-logo:
    url: https://zambo.dev/og-v3.png
  description: 'Operations tagged Zambo across 2 of this provider''s published API definitions: openapi.json, zambo-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://zambo.dev
  description: Production
tags:
- name: Zambo
paths:
  /api/x402/day-pass:
    get:
      tags:
      - Zambo
      summary: 'DAY PASS challenge: Zambo 24h MCP access, $0.99 USDC on Base (x402)'
      description: 'Returns the live x402 v1 exact-payment challenge for the Day Pass: $0.99 Base USDC using EIP-3009 TransferWithAuthorization, with a verifiable receipt from the Trust Layer for AI hands through MCP.'
      operationId: day_pass_challenge
      responses:
        '402':
          description: Payment required - sign the returned EIP-3009 typed data and retry with X-Payment.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 payment requirements.
              schema:
                type: string
            X-Payment-Info:
              description: Human-readable x402 retry instructions.
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                required:
                - x402Version
                - resource
                - accepts
                - on_success_returns
                properties:
                  on_success_returns:
                    type: array
                    items:
                      type: string
                    description: Fields returned after successful settlement, including the canonical /run/<uuid> receipt proof.
                additionalProperties: true
    post:
      tags:
      - Zambo
      summary: 'DAY PASS: 24 hours of Zambo MCP (35 total tools; core entry points on the…'
      description: Zambo is the verifiable work layer for AI. Day Pass = one x402 payment of $0.99 USDC on Base (eip155:8453) for 24 hours of access to the hosted Zambo MCP (https://zambo.dev/mcp). One payment covers 24 hours; no per-request settlement. Submit the base64 EIP-3009 payment envelope in X-Payment; after payment send header X-Zambo-Key. Every job returns a verifiable receipt (/run/, /verify). Same pass via MCP tool day_pass_activate.
      operationId: day_pass
      parameters:
      - name: X-Payment
        in: header
        required: true
        schema:
          type: string
        description: Base64 JSON x402 payment envelope recorded from the live challenge.
      requestBody:
        required: false
        content:
          application/json:
            schema:
              type: object
              description: Optional. Payment is conveyed in the X-Payment header as a base64 JSON x402 envelope; the body may be empty.
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.990000'
        protocols:
        - x402: {}
      x-x402:
        scheme: exact
        network: eip155:8453
        asset: '0x833589fcd6edb6e08f4c7c32d4f71b54bda02913'
        amount: '990000'
        amountUsd: '0.99'
        payTo: '0xb753be5Eac5B29c711051DfF91279834e9C9b9AC'
        header: X-Payment
      responses:
        '200':
          description: Day Pass activated with receipt_url (https://zambo.dev/run/<uuid>), run_id, uuid, expires_at, access_key, how_to_use, and a verifiable spend receipt. If X-Zambo-Key is already active, returns already_active with usage.quota_tier=day_pass and no payment challenge.
        '402':
          description: Payment missing, invalid, or not settled; the body advertises receipt_url, run_id, uuid, access_key, expires_at, x402_spend_receipt, and settlement_tx_hash on success
    servers:
    - url: https://zambo.dev
      description: Production
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
externalDocs:
  description: Full LLM context and integration guide
  url: https://zambo.dev/llms-full.txt
x-refined-from:
- openapi.json
- zambo-dev-openapi.json
x-zambo-stack:
  products: 17
  generated: '2026-09-09'
  builder: Brennan Zambo
  site: https://zambo.dev
x-zambo-work-controls:
  documentation:
  - https://zambo.dev/docs/today/
  - https://zambo.dev/docs/memory/
  - https://zambo.dev/docs/limits/
  - https://zambo.dev/capabilities/
  - https://zambo.dev/today/
  today: https://zambo.dev/today/
  memory: https://zambo.dev/continuity/
  handover: https://zambo.dev/docs/handover/
  limits: https://zambo.dev/docs/limits/
  instructions: 'When a user says ''do this with proof'', ''show me proof'', or ''hand this to my client'': 1. Connect https://zambo.dev/mcp, no key. 2. Call zambo_home. 3. When free calls run out, a funded agent may buy its own $0.99 USDC Day Pass via https://zambo.dev/api/x402/day-pass on Base, within its wallet and user limits, and retry the same call. 4. Human fallback: day_pass_checkout_link after the person agrees to receive a checkout link. Every session result has a private Today link. memory_remember/recall keep private facts; spend_limit_set/status control this work connection''s budget; handover_accept resumes readable work. These tools are free. Receipts check saved bytes, not answer correctness.'
x-mcp-tools:
  activity_today:
    endpoint: https://zambo.dev/mcp
    method: tools/call
    arguments:
      _session_id: Optional when mcp-session-id is present
    description: Read this private work connection's daily receipts.
  zambo_invoke:
    endpoint: https://zambo.dev/mcp
    method: tools/call
    arguments:
      tool: Required tool name
      args: Tool argument object
      arguments: Alias for args