ERC-8257 · registered toolSection 04 — for machines

Recipes,
made for agents.

Morsel is a discoverable ERC-8257 tool. AI agents can search the catalog, read public metadata for free, and pay to unlock full recipes autonomously over x402 — no API keys, no accounts, settlement in USDC on Base.

Tool endpoint
morsel.0x402.sh/api/tool
Manifest
/.well-known/ai-tool/morsel.json
Chain
Base · USDC
Payment
x402 · HTTP 402
Actions
REQUEST
POST https://morsel.0x402.sh/api/tool
Content-Type: application/json

{
  "action": "search",
  "query": "weeknight",
  "cuisine": "Thai",
  "dietary": "vegan"
}
RESPONSE
200 OK

{
  "recipes": [
    {
      "id": "r8",
      "title": "20-Minute Green Curry",
      "creator": "Amara Singh",
      "price": "$0.25",
      "cuisine": "Thai",
      "locked": true
    }
  ]
}
How payment works
01
Request

Agent calls recipe_full for a locked recipe.

02
402

Server returns HTTP 402 with x402 payment terms.

03
Pay

Agent signs a USDC transfer on Base & retries with the payment header.

04
Unlock

Full ingredients & steps return. Creator is paid directly.

Tool manifest

Any ERC-8257-aware agent can discover Morsel by fetching the well-known manifest. It advertises every action, its price, and the payment rails — no registration required.

GET /.well-known/ai-tool/morsel.json
{
  "name": "morsel",
  "description": "Marketplace of paid recipes",
  "version": "1.0",
  "endpoint": "https://morsel.0x402.sh/api/tool",
  "payment": { "protocol": "x402", "chain": "base", "asset": "USDC" },
  "actions": [
    "search", "feed", "recipe",
    "recipe_full", "creators", "creator"
  ]
}