{
  "openapi": "3.1.0",
  "info": {
    "title": "Zambo Stack API",
    "version": "2.0.0",
    "description": "The Zambo Stack API — 19 live products by solo founder Brennan Zambo. Free tier, no auth required. Natural language in, expert structured response out.",
    "contact": {
      "name": "Brennan Zambo",
      "url": "https://zambo.dev",
      "email": "brennanzambo@zambo.dev"
    },
    "license": {
      "name": "MIT",
      "url": "https://opensource.org/licenses/MIT"
    },
    "x-logo": {
      "url": "https://zambo.dev/og-v2.png"
    }
  },
  "externalDocs": {
    "description": "Full LLM context and integration guide",
    "url": "https://zambo.dev/llms-full.txt"
  },
  "servers": [
    {
      "url": "https://zambo.dev",
      "description": "Production"
    }
  ],
  "tags": [
    {
      "name": "Discovery",
      "description": "Agent and capability discovery"
    },
    {
      "name": "ZAMBOT",
      "description": "Agent Evolution Engine — swarm wisdom sparks"
    },
    {
      "name": "ZAMBRO",
      "description": "Opportunity scanner and builder intelligence"
    },
    {
      "name": "ProvibeCode",
      "description": "AI code audit with Provibe Score"
    },
    {
      "name": "LeadSignal",
      "description": "AI lead generation for contractors"
    },
    {
      "name": "GEO",
      "description": "Crawl telemetry and discoverability endpoints"
    },
    {
      "name": "Capabilities",
      "description": "Full endpoint catalog"
    }
  ],
  "paths": {
    "/api/zambot": {
      "get": {
        "tags": [
          "Discovery",
          "ZAMBOT"
        ],
        "summary": "Discover all Zambo Stack capabilities",
        "description": "Returns the full agent manifest: all products, all endpoints, pricing, and quick-start instructions. No auth required.",
        "operationId": "discoverZamboStack",
        "responses": {
          "200": {
            "description": "Full agent manifest",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "endpoints": {
                      "type": "object"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/zambot/spark": {
      "post": {
        "tags": [
          "ZAMBOT"
        ],
        "summary": "Generate a strategy spark",
        "description": "Synthesizes swarm-wisdom breakthroughs from all ${e.products.length} Zambo products. 3 free Sparks/day per IP. Pays 0.001 USDC via x402 on Base for unlimited.",
        "operationId": "zamботSpark",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "goal"
                ],
                "properties": {
                  "goal": {
                    "type": "string",
                    "description": "Your goal, challenge, or question"
                  },
                  "context": {
                    "type": "string",
                    "description": "Optional additional context"
                  }
                }
              },
              "example": {
                "goal": "grow my SaaS to 100 paying users in 90 days"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Strategy spark with swarm wisdom",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "spark": {
                      "type": "string"
                    },
                    "analogies": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "immediate_action": {
                      "type": "string"
                    },
                    "avoid": {
                      "type": "string"
                    },
                    "compound_move": {
                      "type": "string"
                    },
                    "swarm_confidence": {
                      "type": "number"
                    },
                    "proof_hash": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment required — free tier exhausted"
          },
          "429": {
            "description": "Rate limit exceeded"
          }
        }
      }
    },
    "/api/zambot/fix": {
      "post": {
        "tags": [
          "ZAMBOT"
        ],
        "summary": "Fix any code or problem",
        "description": "Submit broken code, an error message, or a stuck problem. Returns a fix with explanation.",
        "operationId": "zambotFix",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "code"
                ],
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "error": {
                    "type": "string"
                  },
                  "context": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Fix and explanation"
          }
        }
      }
    },
    "/api/zambot/stats": {
      "get": {
        "tags": [
          "ZAMBOT"
        ],
        "summary": "ZAMBOT usage stats",
        "operationId": "zambotStats",
        "responses": {
          "200": {
            "description": "Usage statistics"
          }
        }
      }
    },
    "/api/zambro/analyze": {
      "post": {
        "tags": [
          "ZAMBRO"
        ],
        "summary": "Analyze any URL, idea, wallet, or repo",
        "description": "Free always, no auth. Returns opportunity score, insights, and action plan.",
        "operationId": "zambrosAnalyze",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "input"
                ],
                "properties": {
                  "input": {
                    "type": "string",
                    "description": "URL, idea, wallet address, GitHub repo, or any text"
                  }
                }
              },
              "example": {
                "input": "https://github.com/example/myproject"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Opportunity analysis"
          }
        }
      }
    },
    "/api/provibe": {
      "post": {
        "tags": [
          "ProvibeCode"
        ],
        "summary": "AI code audit — free teaser",
        "description": "Audits a GitHub repo. Free tier returns teaser. Full audit requires Builder Pass ($49 PayPal one-time).",
        "operationId": "provibeAudit",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "repo_url"
                ],
                "properties": {
                  "repo_url": {
                    "type": "string",
                    "format": "uri"
                  },
                  "email": {
                    "type": "string",
                    "format": "email",
                    "description": "For full report delivery"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Provibe Score and audit findings"
          }
        }
      }
    },
    "/api/live/agent/zambot": {
      "post": {
        "tags": [
          "Discovery"
        ],
        "summary": "Chat with ZAMBOT agent",
        "operationId": "chatZambot",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "message"
                ],
                "properties": {
                  "message": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Agent response"
          }
        }
      }
    },
    "/api/live/agent/zambro": {
      "post": {
        "tags": [
          "Discovery"
        ],
        "summary": "Chat with ZAMBRO agent",
        "operationId": "chatZambro",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "message"
                ],
                "properties": {
                  "message": {
                    "type": "string"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Agent response"
          }
        }
      }
    },
    "/api/capabilities": {
      "get": {
        "tags": [
          "Capabilities"
        ],
        "summary": "Full endpoint catalog",
        "description": "Returns all available endpoints with descriptions, auth requirements, and rate limits.",
        "operationId": "getCapabilities",
        "responses": {
          "200": {
            "description": "Endpoint catalog"
          }
        }
      }
    },
    "/api/geo/ping": {
      "get": {
        "tags": [
          "GEO"
        ],
        "summary": "Voluntary crawl telemetry ping",
        "operationId": "geoPing",
        "parameters": [
          {
            "name": "page",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Page path being crawled"
          }
        ],
        "responses": {
          "200": {
            "description": "Acknowledged"
          }
        }
      }
    },
    "/api/geo/faq": {
      "get": {
        "tags": [
          "GEO"
        ],
        "summary": "FAQ data for AI context",
        "operationId": "geoFaq",
        "responses": {
          "200": {
            "description": "FAQ entries"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {},
    "schemas": {
      "ZambotSpark": {
        "type": "object",
        "properties": {
          "spark": {
            "type": "string",
            "description": "Core strategic insight"
          },
          "analogies": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Cross-domain analogies"
          },
          "immediate_action": {
            "type": "string"
          },
          "avoid": {
            "type": "string"
          },
          "compound_move": {
            "type": "string"
          },
          "swarm_confidence": {
            "type": "number",
            "minimum": 0,
            "maximum": 1
          },
          "proof_hash": {
            "type": "string",
            "description": "Cryptographic proof, verify at /api/zambot/verify/:hash"
          }
        }
      }
    }
  },
  "x-zambo-stack": {
    "products": 19,
    "generated": "2026-06-13",
    "builder": "Brennan Zambo",
    "site": "https://zambo.dev"
  }
}