> **Test site:** demo restaurants and test orders only. Nothing here is a real restaurant or a real order.

<!-- canonical: http://localhost:3000/agents; language: en; other language: http://localhost:3000/fr/agents -->

# For AI agents

Menu.ca has a text version of every page, a REST API and an MCP server. No registration, no CAPTCHA, no human confirmation.

- OpenAPI: http://localhost:3000/api/v1/openapi.json
- MCP (Streamable HTTP): http://localhost:3000/mcp
- Server card: http://localhost:3000/mcp/server-card
- llms.txt: http://localhost:3000/llms.txt

Fast path: search → menu → quote → place order → status. Orders are sandbox tests on this site.

## Text versions of pages

Every page has a text version. Add .md to its address: that always works. Asking for text/markdown also works, but some hosts answer it themselves, without our ids and live status.

- http://localhost:3000/ottawa.md
- http://localhost:3000/ottawa/pelican-lane-pizza.md

## The fast path

menuca_order_now makes an order card and places it in one call. Items can be given by name, in English or French. A name that matches more than one thing, or nothing, comes back as a 422 with the candidates.

## Order cards

Every order is placed from an order card: a cart frozen at a moment and priced by the restaurant. A card never changes. If a price moved when you place one, nothing is placed: you get a 409 card_changed with the new total and a replacement card. Each card has a page people can open and share, and a text version.

## Order for a person

An agent connected to a person's Menu.ca account uses their name, default address and payment, and its orders join their history. Menu.ca adds no limits, approvals or caps for agents.

- Claude: go to Customize, Connectors, Add custom connector. Enter http://localhost:3000/mcp/me. Leave the OAuth client as “Use Claude's published identity”, click Add, then Connect, sign in to Menu.ca and choose Allow.
- ChatGPT: open chatgpt.com/plugins, choose +, then Add custom MCP server. Enter http://localhost:3000/mcp/me, choose Create as a plugin, and sign in to Menu.ca when asked.
- Browser agents (they use the website like a person): open an order card's link, fill in the name and press Place this order. Every control has a visible text label.
- Any other agent: make a key at http://localhost:3000/account/agents and send it as a Bearer token to http://localhost:3000/mcp/me or http://localhost:3000/api/v1/me.
- A short skill file any agent can load: http://localhost:3000/agents/skill.md
- OAuth metadata: http://localhost:3000/.well-known/oauth-authorization-server
