Agentic Commerce

McFlamingo, for agents.

Every dish is machine-readable and orderable by autonomous agents. We expose three protocols: schema.org JSON-LD + /menu.json for discovery, MCP for order intake, and USDC on Base for verified wallet payments.

Endpoints

GET/menu.jsonFull machine-readable menu (also at /api/menu).

GET/llms.txtAI crawler manifest (also served at /llm.txt).

GET/llms-full.txtEvery menu item, price, tag and business fact in one plain-text fetch.

GET/ai.txtAI usage terms and attribution policy.

GET/gallery/llms.txtPhoto index with captions and keywords.

GET/.well-known/agent.jsonAgent capabilities & endpoint discovery.

POST/api/mcpModel Context Protocol JSON-RPC endpoint. Tools: list_menu, get_item, place_order, confirm_payment, get_order_status. Pay autonomously in USDC on Base; x402 resource: /api/public/agent-order/{order_id}/pay.

GET / POST/api/public/agent-order/{order_id}/payOrder-specific HTTP 402 requirements and USDC transaction verification. Use the URL returned by place_order.

MCP example

List the full menu:

curl -X POST https://www.mcflamingo.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"list_menu","arguments":{}}}'

McFlamingo-owned payment

Call place_order through MCP. The quote includes tax and a per-order payment URL. x402 wallets POST a signed exact (EIP-3009) payment in X-PAYMENT and McFlamingo settles it on Base. Or send the exact USDC amount yourself and pass the transaction hash to confirm_payment. Verified payments reach the kitchen and are stored in Admin.

Offer separate optional kitchen-team and delivery-provider tips using tip_kitchen_usd and tip_driver_usd. Both default to $0; confirm each recipient amount with the guest before payment. Provider tips require delivery and are refunded, not redirected, if the order switches to pickup. The delivery fee is not a tip, and collected sales tax is not driver pay.

curl -X POST https://www.mcflamingo.com/api/mcp   -H 'Content-Type: application/json'   -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"place_order","arguments":{
         "items":[{"item":"ITEM_ID_FROM_LIST_MENU","qty":1,"changes":["sauce on the side"]}],
         "agent_name":"Your agent"}}}'

Schema.org markup

The home page emits Restaurant JSON-LD and /menu emits Menu + MenuItem + Offer markup so general-purpose crawlers (ChatGPT, Perplexity, Gemini) can index every dish and price.