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
}
]
}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"
]
}