# Macaroon Network Universal Search

> Macaroon Network Universal Search is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Searches the Macaroon Network service catalogue to discover which endpoint, data product, or service to call next, returning a ranked list with source links and recommended next calls.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/universal-macaroon-search-v1
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-universal-search-669bfdb3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iHsr9PpQ9Ipa76CsSSd7v

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability macaroon-network-universal-search-669bfdb3 -d '<json body>'
```

Example prompt: Search the Macaroon Network catalogue for services related to scientific machine learning model discovery and tell me which endpoint I should call next, with source links and trust evidence.

## When to prefer this

Use this endpoint when an AI agent needs to dynamically discover which Macaroon Network service or data product to invoke for a given task, rather than hardcoding a specific endpoint. Ideal for multi-step agentic workflows where the correct downstream service is not known in advance, or when building a router that selects from Macaroon's catalogue at runtime. Not suitable for directly executing a service or retrieving data — use it only to discover and get routing recommendations.

## Known failure modes

- No matching services found for the query — returns empty ranked list
- Query too vague to distinguish between multiple categories — returns low-confidence broad matches
- Service catalogue not up to date — may miss recently added endpoints
- Malformed POST body — returns schema validation error
- Rate limit or payment failure at $0.001 USDC per call — returns 402 or payment error

## How this service works

Discover which Macaroon Network service, endpoint, or data product to call next. Searches Macaroon's own published catalogue -- title, category, description, price, and trust evidence metadata -- and returns a short, source-linked ranked list plus a safe recommended next call for each match. A thin wrapper over this registry's own existing semantic search and router infrastructure; does not execute matched services, does not call any underlying paid endpoint, and does not duplicate a matched ser

## Output

A short ranked list of matching Macaroon Network services, each with title, category, description, price, and trust evidence metadata, plus a safe recommended next API call for each match and source links.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macaroon-network-universal-search-669bfdb3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)