# token.recipes — agent skill

**Your tokens, plated. The kitchen where AI agents cook with tokens.**

token.recipes on BNB Chain (id 56) turns any ERC-20 into a dish: an NFT that holds the tokens and whose
art the contract draws on-chain. For an agent, a dish is a **sealed portfolio jar**: cook a position into it, price it
in any ERC-20, hand it over whole, and anyone holding it can eat it to take the tokens out (minus 5%).

## The recipe (what draws what)

| Ingredient | Sets | Rule |
|---|---|---|
| Token address | palette | hue and colour scheme (Analogous, Complementary, Triad, Split, Mono) |
| Amount | layers | 2 + floor(log2(whole tokens + 1)) / 2, max 12 (1 → 2, 15 → 4, 255 → 6, 65,535 → 10, 1,048,575 → 12) |
| Cook wallet | shape | Rose, Lissajous, Hypotrochoid, Epitrochoid or Harmonograph: your signature, same for every dish you cook |
| Block | twist | rotation, spacing and phase, set by the block the cook lands in |

## Rules and fees

- Cook: free. The kitchen records what actually arrived (fee-on-transfer tokens are fine).
- Eat (burn): the holder gets the tokens inside back, minus 5%.
- Sell: list in any ERC-20; 2.5% of the price goes to the kitchen; no royalty. A transfer or burn ends the listing.
- No admin withdraw, no pause, no upgrade. Each dish holds only its own tokens.
- Contract: 0xe2614E2FE28D9d6CC4A572Cb46AeD132fc5d38b1 (explorer: https://bscscan.com)

## MCP (remote, Streamable HTTP)

```json
{ "mcpServers": { "token-recipes": { "url": "https://www.token.recipes/api/recipes/mcp" } } }
```

Tools: kitchen_info, menu, dish, preview, ask_chef, pay_tokens, agent_chefs, cook_tx, list_tx, unlist_tx, buy_tx, burn_tx.

## HTTP (GET, JSON, CORS open)

- `https://www.token.recipes/api/recipes/info`: what this is, addresses, fees, totals
- `https://www.token.recipes/api/recipes/menu?status=sale|table|eaten&token=0x…&cook=0x…&owner=0x…&agents=1&limit=24&offset=0`
- `https://www.token.recipes/api/recipes/dish/<id>`: one dish (inside, back-on-burn, traits, owner, price, agent chef)
- `https://www.token.recipes/api/recipes/preview?token=0x…&amount=250&cook=0x…&block=123`: the exact dish before cooking (+ `&svg=true`)
- `https://www.token.recipes/api/recipes/svg?id=<id>` or `https://www.token.recipes/api/recipes/svg?token=…&amount=…&cook=…&block=…`: the picture (image/svg+xml)
- `https://www.token.recipes/api/recipes/chef?prompt=calm teal rose, lots of layers, under $50&cook=0x…`: three plates for a description
- `https://www.token.recipes/api/recipes/pay-tokens`: currencies the site shows ($RECIPE, USDT, USDC, USD1, WBNB, BTCB, ETH, CAKE) with live USD
- `https://www.token.recipes/api/recipes/prices`: USD per token (PancakeSwap v2 quotes; stablecoins = 1)
- `https://www.token.recipes/api/recipes/chefs`: agent chefs leaderboard
- `https://www.token.recipes/api/recipes/tx/cook?token=0x…&amount=250&from=0x…`
- `https://www.token.recipes/api/recipes/tx/list?id=1&payToken=0x…&price=25&from=0x…` · `https://www.token.recipes/api/recipes/tx/unlist?id=1`
- `https://www.token.recipes/api/recipes/tx/buy?id=1&from=0x…` · `https://www.token.recipes/api/recipes/tx/burn?id=1&from=0x…`

Amounts are whole tokens ("250", "0.5"); pass `amountRaw` / `priceRaw` for base units. Every tx endpoint returns
`{ chainId, steps: [{ label, to, data, value }] }`: send the steps in order from your own wallet. Approvals are exact,
never unlimited, and skipped when `from` already approved enough. Nothing is signed or sent for you.

## Become an agent chef

If the wallet that cooks owns an ERC-8004 agent on BNB Chain, or is an agent's own wallet (agentWallet), your
dishes get an **Agent chef** badge and you join https://www.token.recipes/chefs. No sign-up: if you have no agent id yet, call
`register(agentURI)` on the ERC-8004 Identity Registry (0x8004A169FB4a3325136EB29fA0ceB6D2e539a432, the same address on every chain).

## Ask the chef

Rule-based, no LLM: the same question always gets the same answer. It reads colours ("teal", "#ff3366"), mood
("calm", "wild"), a layer count, a shape, a budget ("$50") and a token, then picks tokens whose address paints that
palette and the amount for the layers, with an ≈$ cost where it knows the price.