---
name: menu-ca
description: Find restaurants and order food from independent Ontario and Quebec restaurants on Menu.ca, for yourself or for the person you work for. Use it when someone wants to order food, repeat a past order, or know what is on a restaurant's menu.
---

# Menu.ca

TEST SITE: orders are sandbox tests; no food is made and no money moves. Menu.ca lists independent restaurants in Ontario and Quebec. Restaurants that are **on Menu.ca** (kind `client`) can be ordered from. Everything else is listed so people can find it, and must be sent to the restaurant's own website.

## Where to call

| | Anonymous (no account) | For a person (their account) |
|---|---|---|
| MCP | `http://localhost:3000/mcp` | `http://localhost:3000/mcp/me` (OAuth) |
| REST | `http://localhost:3000/api/v1` | `http://localhost:3000/api/v1/me/…` with a Bearer token or key |
| Description | OpenAPI: `http://localhost:3000/api/v1/openapi.json` | Same document, plus the `/me` endpoints |

Connecting to a person's account: the MCP server and the REST API answer `401` with a `WWW-Authenticate` header that points to the OAuth metadata (`http://localhost:3000/.well-known/oauth-protected-resource/mcp/me`). Add `http://localhost:3000/mcp/me` as a custom connector, or ask the person for a key from http://localhost:3000/account/agents and send it as `Authorization: Bearer mca_key_…`.

MCP versions: every MCP address answers 2025-11-25 (start with `initialize`) and 2026-07-28 (no handshake and no session: send `MCP-Protocol-Version: 2026-07-28` and the version in `_meta` on each request; start with `server/discover`). Order status: read it with `menuca_get_order_status`, or have it pushed by webhook (`menuca_subscribe_order_events`). Resource subscriptions are not offered.

## Text versions of pages

To read a page as text, add `.md` to its address: http://localhost:3000/ottawa/pelican-lane-pizza.md, http://localhost:3000/ottawa.md, http://localhost:3000/llms.txt. That always gives this site's own text, with ids and live status. (`Accept: text/markdown` also works, but some hosts answer it with their own conversion before it reaches this site; if the text has no `mca_` id in it, use the `.md` address.)

## The fast path

**`menuca_order_now`** (REST: `POST /api/v1/quick-orders`) makes the order and places it in one call. Lines can use names instead of ids:

```json
{
  "public_id": "mca_abcd2345",
  "fulfillment": "pickup",
  "lines": [{ "item": "Margherita", "qty": 2 }, { "item": "Pop" }],
  "payment": "test_card_success",
  "contact": { "name": "Sam Lee", "email": "sam@example.com" },
  "idempotency_key": "order-2026-10-07-sam-0001"
}
```

For a person's connected agent, `payment` and `contact` are optional: the person's own name and default payment are used, and the order joins their history as "Placed by {your name}".

If a name matches more than one thing you get `422 ambiguous_item` (or `ambiguous_option`) with candidates (id, name, price). An unknown name gives `422 item_not_found` with the closest five. Names match English or French, ignoring case and accents.

## Order cards

Every order is placed from an **order card**: a cart frozen at a moment and priced by the restaurant's ordering system. A card never changes. Use `menuca_create_order_card` to make one, `menuca_get_order_card` to read one (it is also a web page at `http://localhost:3000/o/{card_id}` and `…/o/{card_id}.md`), and `menuca_place_order_card` to place it. Placing prices the card again first. If anything moved (a price, a sold-out item, a fee), nothing is placed and you get `409 card_changed` with the differences and a replacement card. Show the person the new total, or send `accept_changes: true`.

An Idempotency-Key (8 to 80 characters) is required to place. Sending the same key again returns the same order. Use a new key for each new order.

## Rules

- **Prices come only from a card or a quote.** They are integer cents in CAD. Never add up or estimate a total.
- **Allergens and diets:** say an item is vegetarian, gluten-free, nut-free and so on only if its `dietary_confirmed` list says so. Otherwise say the restaurant hasn't confirmed it and give its phone number.
- **Restaurants that are not on Menu.ca** (`kind` is `non_client`): say they are not on Menu.ca and give their website (`website`; if none, `phone`, then `how_to_order`). Do not offer to order from them. A `legacy` restaurant takes orders on its own page (`order_on_their_page`).
- **You can place orders directly.** There is no confirmation step, no sign-up for anonymous use, and no cap. Rate limits answer `429` with `Retry-After`.
- Orders on test sites (this one says so) are sandbox tests: no food is made and no money moves.
- Send `lat` and `lng` with delivery addresses: there is no geocoder yet, so a city name alone resolves to the middle of the city.

## Examples

**1. "Order my usual"** (connected to the person):
`menuca_list_my_order_cards` (saved "usuals" come first) → `menuca_reorder` with the `card_id` (a new card, priced now, with `differences`) → tell the person about any difference → `menuca_place_order_card` with that card and a new `idempotency_key`. No payment or contact needed.

**2. "Pizza for 4 from Pelican Lane Pizza, for pickup":**
`menuca_search_restaurants` (`q` is the name; check `kind` is `client` and `orderable` is true) → `menuca_get_menu` → `menuca_order_now` with `"lines": [{ "item": "Margherita", "qty": 2 }, …]`, `"fulfillment": "pickup"`, a payment and a contact → give the person the `status_url`.

**3. "What's on Pelican Lane Pizza's menu that's vegetarian?"**
`menuca_get_menu` → list the items whose `dietary_confirmed` includes `vegetarian` → for items without a confirmation say the restaurant hasn't confirmed and give its phone.

More: http://localhost:3000/agents · http://localhost:3000/llms.txt
