Discovery

POST/v1/discovery/search

Scope discovery:read. The body is optional, and every field is optional.

Field	Type	Notes
`query`	string	natural language: `"extract text from invoices"`
`category`	string	exact category
`protocol`	`"rest"` \| `"mcp"`
`maxPriceMinor`	string	cents: `"200"` = at most $2.00
`maxLatencyMs`	number	advertised median latency ceiling
`limit`	integer ≥ 1

Terminal

curl -s -X POST https://api.zanora.dev/v1/discovery/search -H "x-api-key: $KEY" \
  -H 'content-type: application/json' \
  -d '{"query":"extract text from invoices","maxPriceMinor":"200","limit":3}'

JSON

{
  "results": [
    {
      "capability": {
        "id": "cap_…", "name": "Invoice OCR (demo)", "protocol": "rest", "priceMinor": "100",
        "currency": "USD", "category": "OCR", "tags": ["invoices"], "schema": { "…": "…" }, "status": "active"
      },
      "version": { "endpoint": "https://demo-seller.zanora.dev/ocr", "address": { "kind": "url", "url": "…" }, "version": "…" },
      "provider": { "id": "prv_…", "name": "Zanora Demo", "verified": true, "reputation": 0.92 },
      "score": 0.87,
      "scoreBreakdown": { "…": 0 }
    }
  ]
}

Only active capabilities from verified, unsuspended sellers are returned, best first. MCP results include capability.toolName. Package capabilities come back with a package address.

Read the schema before paying

capability.schema is the request body's JSON Schema. A request that doesn't match it will probably fail on the seller's side, and a failed call is refunded, but reading the schema first avoids the wasted round trip.