{
  "name": "menu-ca",
  "title": "Menu.ca",
  "version": "1.0.0",
  "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Find and order from independent restaurants.",
  "documentation": "http://localhost:3000/agents",
  "skill": "http://localhost:3000/agents/skill.md",
  "text_versions": {
    "how": "Add .md to a page's address. It always returns this site's own text, with ids and live status.",
    "example": "http://localhost:3000/ottawa.md",
    "llms_txt": "http://localhost:3000/llms.txt"
  },
  "transport": {
    "type": "streamable-http",
    "url": "http://localhost:3000/mcp",
    "stateless": true
  },
  "transports": [
    {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp",
      "stateless": true,
      "authentication": {
        "required": false
      },
      "description": "Anonymous: what a guest can do. No account, no sign-up."
    },
    {
      "type": "streamable-http",
      "url": "http://localhost:3000/mcp/me",
      "stateless": true,
      "authentication": {
        "required": true,
        "type": "oauth2",
        "scopes": [
          "account"
        ],
        "protected_resource_metadata": "http://localhost:3000/.well-known/oauth-protected-resource/mcp/me",
        "authorization_server_metadata": "http://localhost:3000/.well-known/oauth-authorization-server",
        "client_id_metadata_document_supported": true,
        "dynamic_client_registration": "http://localhost:3000/oauth/register",
        "api_key": "A key made by the person at http://localhost:3000/account/agents, sent as a Bearer token"
      },
      "description": "Connected to a person's Menu.ca account: their defaults, their orders, their addresses. Same powers as the person when ordering."
    }
  ],
  "authentication": {
    "required": false
  },
  "tools": [
    {
      "name": "menuca_ping",
      "title": "Ping",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Check that the Menu.ca server is reachable. Returns the server time and whether this is a test site."
    },
    {
      "name": "menuca_list_markets",
      "title": "List markets",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. List the cities Menu.ca covers, with restaurant counts. Use a market's slug in other tools."
    },
    {
      "name": "menuca_search_restaurants",
      "title": "Search restaurants",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Search restaurants and dishes. Restaurants you can order from on Menu.ca ('client', orderable) are always ranked first; others are listed plainly with how to order from them. Dietary filters only match what restaurants have confirmed. On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_get_restaurant",
      "title": "Get restaurant",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Details for one restaurant: status, hours, address, how to order. Non-clients show facts with the date and source of each, never menus or prices."
    },
    {
      "name": "menuca_get_menu",
      "title": "Get menu",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The menu with live prices, item ids and option groups. Only restaurants that are on Menu.ca have one. Allergens appear only where the restaurant confirmed them (dietary_confirmed); otherwise phone the restaurant. On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_check_delivery",
      "title": "Check delivery",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Whether a restaurant on Menu.ca delivers to an address, with the fee, minimum and estimated time. Send lat/lng for an exact answer; the sandbox has no geocoder."
    },
    {
      "name": "menuca_get_quote",
      "title": "Get quote",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Price an order. All amounts come from the restaurant's quote: items, delivery fee, named tax lines, tip and total, in integer cents. A quote is valid for 15 minutes. Do not compute prices yourself. On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_place_order",
      "title": "Place order",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Place an order from a quote. Agents place orders directly: no confirmation step, no registration, no caps. Idempotent on idempotency_key (or the Idempotency-Key header). On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_get_order_status",
      "title": "Get order status",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The current status of an order, by its token. Sandbox orders advance by time: received, accepted, ready or out for delivery, completed."
    },
    {
      "name": "menuca_request_online_ordering",
      "title": "Request online ordering",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Tell Menu.ca a person would order online from a restaurant that isn't on Menu.ca yet. Records anonymous demand only; it does not place an order and sends nothing to the restaurant."
    },
    {
      "name": "menuca_get_reviews",
      "title": "Get reviews",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. A restaurant's published reviews, newest first, each with the restaurant's public reply, and its average once there are enough reviews to show one. Only restaurants on Menu.ca have reviews here. Reviewers are shown by first name and initial."
    },
    {
      "name": "menuca_create_order_card",
      "title": "Create order card",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Freeze an order as an order card, priced now by the restaurant's ordering system: a cart that never changes afterwards. Lines take item_id or the item's name; selections take ids or names. Returns the card, a web link people can open and share, and how to place it. Nothing is ordered yet. On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_get_order_card",
      "title": "Get order card",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. An order card and, if you made it or it is your person's, the orders placed from it. The delivery address is complete only for its owner. On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_place_order_card",
      "title": "Place order card",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Place an order card. It is priced again first: if anything changed (a price, an item that sold out, a fee), nothing is placed and the answer is 409 card_changed with the differences, a replacement card and its total; send accept_changes true to place the replacement instead. Agents place directly: no confirmation step, no sign-up, no cap. Payment and contact are required unless you are connected to a person, whose defaults are then used. Idempotent on idempotency_key (or the Idempotency-Key header). On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_order_now",
      "title": "Order now",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The easiest way to order: make the order card and place it in one call. Lines take item_id or the item's name (English or French); selections take ids or names. A name that matches several things is 422 ambiguous_item (or ambiguous_option) with the candidates; an unknown name is 422 item_not_found with the closest five. Agents place directly: no confirmation step, no sign-up, no cap. Payment and contact are required unless you are connected to a person, whose defaults are then used. Idempotent on idempotency_key (or the Idempotency-Key header). On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_get_me",
      "title": "Get my account",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The person this agent is connected to: name, language, market, saved addresses (the default first) and how they pay by default. Their own defaults are used when you place an order without payment or contact."
    },
    {
      "name": "menuca_add_address",
      "title": "Add an address",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Save a delivery address on the person's account, and optionally make it their default. Send lat and lng when you have them: the sandbox has no geocoder."
    },
    {
      "name": "menuca_list_my_orders",
      "title": "List my orders",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The person's orders, newest first, paged. Each has the restaurant, a summary of the items, the total, when it was placed, its status, the order card it was placed from, and who placed it (a person, or an agent such as you)."
    },
    {
      "name": "menuca_list_my_favourites",
      "title": "List my favourites",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The restaurants the person saved as favourites, with whether each can be ordered from now."
    },
    {
      "name": "menuca_list_my_order_cards",
      "title": "List my order cards",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The person's order cards: the ones they saved as usuals first (with the name they gave), then the most recent others. Use a card_id with menuca_place_order_card, or menuca_reorder to price one again."
    },
    {
      "name": "menuca_save_order_card",
      "title": "Save an order card as a usual",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Save one of the person's order cards under a name (\"Friday pizza\") so it can be found first next time. The card itself is not changed."
    },
    {
      "name": "menuca_reorder",
      "title": "Order again",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Order a past order or card again: a NEW order card priced now from the old one, with every difference listed (price changes, items that sold out or were removed, options that changed) and how many lines had to be left out. Nothing is placed: call menuca_place_order_card with the new card."
    },
    {
      "name": "menuca_submit_review",
      "title": "Review a completed order",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Leave the person's review of one of their completed orders placed on menu.ca (round 2, C6): stars, their own words, optional sub-ratings, a thumb per item and a private note to the restaurant. Send only what the person said. Reviewing the same order again changes the review (for 30 days). Every review is checked before it is published; there is no reward for a review."
    },
    {
      "name": "menuca_get_preferences",
      "title": "Get my preferences",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. What the person asked Menu.ca to remember: language, market, pickup or delivery, default address and tip, dietary choices (which only ever filter or label against what a restaurant confirmed), dislikes, and how they pay by default."
    },
    {
      "name": "menuca_update_preferences",
      "title": "Update my preferences",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Change what the person asked Menu.ca to remember. Send only the fields to change; null clears one. default_payment is a way to pay the person has (see menuca_list_payment_methods): orders their agents place with no payment named use it."
    },
    {
      "name": "menuca_list_usuals",
      "title": "List my usuals",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The orders the person saved as a usual, each an order card with its label, restaurant and total as priced when saved. Order one with menuca_order_usual."
    },
    {
      "name": "menuca_order_usual",
      "title": "Order my usual",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Order one of the person's usuals in one call: it is priced again, and placed with the person's name and default way to pay unless you send others. If anything changed (a price, an item sold out), nothing is placed and the answer is 409 card_changed with the differences and a replacement; send accept_changes true to place the replacement. Agents place directly: no confirmation step, no cap. Idempotent on idempotency_key (or the Idempotency-Key header). On this site orders are sandbox tests: no food is made and no money moves."
    },
    {
      "name": "menuca_list_payment_methods",
      "title": "List my ways to pay",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The ways the person can pay at a restaurant, as its ordering system offers them: their saved cards (brand and last four digits only), a new card, its pay page, and paying at the door where it takes that. Says which one is their default."
    },
    {
      "name": "menuca_get_receipt",
      "title": "Get a receipt",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. The receipt of one of the person's orders, read from its order card: lines, taxes, tip, total, how it was paid and where it stands. Amounts are the restaurant's ordering system's, in cents."
    },
    {
      "name": "menuca_report_order_issue",
      "title": "Report a problem with an order",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Tell the restaurant's support desk about a problem with one of the person's orders: a missing or wrong item, late, cold, never arrived, or something else, in the person's words. The same report twice within a minute counts once."
    },
    {
      "name": "menuca_list_my_consents",
      "title": "List my consents",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. What the person agreed to receive: Menu.ca's own offers by email, each restaurant's offers they agreed to, and the restaurants they asked to hear about when they join."
    },
    {
      "name": "menuca_set_consent",
      "title": "Change a consent",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. Change what the person receives, as they can on their account page: turn Menu.ca's own offers by email on or off, stop a restaurant's offers, or stop a 'tell me when they join' notice. Turning a restaurant's offers on is done at that restaurant's checkout, where its wording is shown."
    },
    {
      "name": "menuca_subscribe_order_events",
      "title": "Subscribe to order events",
      "description": "TEST SITE: orders are sandbox tests; no food is made and no money moves. A webhook for the orders this connection places: each new status (received, accepted, ready, out for delivery, completed, cancelled) is POSTed once as order.status_changed, signed with the secret in this answer (Menuca-Signature: t=…,v1=HMAC-SHA256 of `t.body`). The secret is shown once. https only."
    }
  ],
  "experimental": "MCP server cards are experimental; this path may change."
}