zambo-dev Universal API

openapi: 3.2.0
info:
  title: Zambo Dev Universal 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 universal 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: universal
  description: Universal routing endpoint - one call, all products
paths:
  /api/zambo:
    post:
      tags:
      - universal
      operationId: zamboUniversal
      summary: Universal API - one call, all products
      description: Send a natural-language need for truthful routing. Use the canonical MCP endpoint for receipt-backed execution. Free limits apply.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - need
              properties:
                need:
                  type: string
                  description: Natural language description of what you need
                  example: Audit my public code hosting repo for security issues
                context:
                  type: object
                  description: Optional extra context (repo_url, goal, trade, city, wallet, domain)
                format:
                  type: string
                  enum:
                  - json
                  - markdown
                  default: json
      responses:
        '200':
          description: Expert structured response with product routing and results
        '429':
          description: Rate limit reached - 20 free/day/IP
    get:
      tags:
      - universal
      operationId: zamboApiDocs
      summary: Zambo API documentation and routing guide
      description: Returns full documentation for Zambo's 153 MCP tools (core entry points on the default surface), endpoints, and routing logic.
      responses:
        '200':
          description: Full API docs with product catalog and routing guide
    servers:
    - url: https://zambo.dev
      description: Production
  /api/ask:
    get:
      tags:
      - universal
      operationId: zamboAskGet
      summary: Natural language Q&A about Zambo
      description: Ask any question about Zambo - tools, pricing, routing, capabilities, how-tos. Returns structured answer with products_mentioned and CTA. 20 free/day/IP, no auth.
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Your question
        example: What is ZAMBRO and how do I use the API?
      responses:
        '200':
          description: Structured answer with products_mentioned and routing CTA
    post:
      tags:
      - universal
      operationId: zamboAskPost
      summary: Natural language Q&A (POST variant)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - q
              properties:
                q:
                  type: string
                  description: Your question
                context:
                  type: string
                  description: Optional extra context
      responses:
        '200':
          description: Structured answer with routing
    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