Skip to content

canuckeats/MCP

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 

Repository files navigation

Canuckeats MCP — AI-Powered Canadian Food Delivery

Order UberEats and DoorDash in Canada through AI agents. Canuckeats is a Model Context Protocol (MCP) service that lets AI agents browse menus and place real food delivery orders across 89 Canadian cities — no human in the loop required.

Endpoint: https://mcp.canuckeats.com/mcp
Registration: POST https://mcp.canuckeats.com/register — free, instant, no email confirmation
Protocol: MCP 2024-11-05 — Streamable HTTP
Coverage: 17,000+ restaurants · 89 cities · Canada only · UberEats + DoorDash


Why Canuckeats for Agents?

Canadian residents who want AI assistants to handle their food delivery face a gap: UberEats and DoorDash don't offer agent-accessible APIs. Canuckeats bridges that gap. An agent given a task like "order me sushi for dinner" can:

  1. Find open restaurants near the user's address in their city
  2. Browse full menus with prices and modifier options
  3. Get a precise cost breakdown before charging anything
  4. Place the order and confirm payment in a single tool call
  5. Track delivery status and report the ETA back to the user

Every order dispatches through real UberEats or DoorDash accounts — the same food, same drivers, same cities.


Get an API Key — Instant Self-Signup

No waiting, no approval queue. Register your agent and start making calls in under 30 seconds:

POST https://mcp.canuckeats.com/register
Content-Type: application/json

{
  "agent_name": "MyFoodAgent",
  "email": "you@yourproject.com",
  "description": "AI assistant that orders lunch for remote teams"
}

Response:

{
  "api_key": "your-api-key-shown-once",
  "key_id": "uuid",
  "scopes": ["catalog:read", "orders:write"],
  "medusa_customer_id": "cus_...",
  "mcp_endpoint": "https://mcp.canuckeats.com/mcp",
  "docs": "https://github.com/canuckeats/MCP",
  "message": "Registration successful. Keep your API key secure — it is shown only once and cannot be retrieved again."
}

The key is shown once. Save it immediately. If you lose it, register again with the same email — duplicate email is rejected, so use a unique email per key.

Registration limits: Up to 5 registrations per IP per 24 hours. One key per email address. Disposable email addresses are not accepted.


What Cities Are Covered?

All major Canadian cities: Calgary, Edmonton, Vancouver, Toronto, Ottawa, Montreal, Winnipeg, Hamilton, London, Halifax, Saskatoon, Regina, Kelowna, Victoria, Abbotsford, Barrie, Brampton, Burlington, Burnaby, Coquitlam and 69 more across Alberta, British Columbia, Ontario, Manitoba, Saskatchewan, Nova Scotia, New Brunswick and other provinces.

Use list_cities to get the current full list with restaurant counts.


8 Tools — Full Order Lifecycle

Tool Auth Description
list_cities API key List all 89 cities with restaurant counts
search_restaurants API key Search by city, cuisine, name, or price range
get_restaurant API key Full restaurant details
get_menu API key Complete menu with sections, prices, and modifier options
validate_order API key Preview exact total — no charge, no order created
create_order API key Create order + Stripe PaymentIntent (no charge yet)
confirm_payment API key Charge card and dispatch order to platform
get_order_status API key Live status, tracking URL, and ETA

Quickstart: Connect in 60 Seconds

Python (using mcp SDK)

import asyncio, json
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client(
        "https://mcp.canuckeats.com/mcp",
        headers={"Authorization": "Bearer YOUR_API_KEY"}
    ) as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()

            # Find restaurants
            result = await session.call_tool("search_restaurants", {
                "city_slug": "vancouver-bc",
                "query": "sushi",
                "limit": 5
            })
            restaurants = json.loads(result.content[0].text)
            print(f"Found {restaurants['total']} sushi spots in Vancouver")

asyncio.run(main())

TypeScript / Node.js

import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"

const client = new Client({ name: "my-agent", version: "1.0" }, { capabilities: {} })
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://mcp.canuckeats.com/mcp"),
  { requestInit: { headers: { Authorization: "Bearer YOUR_API_KEY" } } }
))

const result = await client.callTool({ name: "list_cities", arguments: {} })
const cities = JSON.parse(result.content[0].text)
console.log(`${cities.length} cities available`)

Claude Desktop Integration

Add to your Claude Desktop MCP config (claude_desktop_config.json):

{
  "mcpServers": {
    "canuckeats": {
      "type": "streamable-http",
      "url": "https://mcp.canuckeats.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Then ask Claude: "Order me a pepperoni pizza from anywhere in Calgary to 400 4 Ave SW, Calgary AB T2P 0J4."


Complete Order Flow

list_cities                  →  get city slug (e.g. "calgary-ab")
  ↓
search_restaurants           →  get restaurant id
  ↓
get_menu                     →  get menu_item_id + modifier options
  ↓
validate_order               →  confirm total (no charge)
  ↓
create_order                 →  get order_id + stripe_payment_intent_id
  ↓
confirm_payment              →  charge pm_... and dispatch
  ↓
get_order_status (poll)      →  track until delivered

See docs/examples/order-flow.md for a narrated walkthrough with real request/response examples.


Rate Limits

Endpoint Limit
/register 5 registrations per IP per 24 hours
All tools (general) 60 requests / minute per key
create_order, confirm_payment 10 requests / minute per key

Response headers X-RateLimit-Limit and X-RateLimit-Remaining are included on every MCP response.


Key Facts for Agents

  • Canadian addresses only. Province must be a two-letter code: AB, BC, ON, QC, MB, SK, NS, NB, NL, PE, NT, YT, NU.
  • Payment method: confirm_payment accepts a Stripe pm_* payment method ID. The agent's operator must provide a valid Stripe payment method that has already been set up with Stripe.
  • Order dispatch is automatic. After confirm_payment succeeds, orders are forwarded to UberEats or DoorDash within 2–5 minutes. Use get_order_status to track.
  • Delivery platform is chosen automatically based on which platform has that restaurant in its catalog.
  • source_id on menu items is used internally — you do not need to reference it directly. Just use menu_item_id (the integer id field) when calling create_order.
  • Modifiers are optional. If a menu item has required modifiers (e.g. drink size), omitting them may cause the order to fail at the platform level. Check modifier_groups[].min_selections to know which are required.
  • Scheduled delivery is supported via the scheduled_for ISO 8601 field on create_order. Use ASAP delivery by omitting this field.

Supported Delivery Platforms

Platform Coverage
UberEats All 89 cities
DoorDash All 89 cities

Orders are placed on whichever platform has the requested restaurant. The source field on each restaurant ("ubereats" or "doordash") tells you which platform will be used.


Canadian Cities — Full List

Alberta · British Columbia · Manitoba · New Brunswick · Newfoundland · Nova Scotia · Ontario · Prince Edward Island · Quebec · Saskatchewan

Use list_cities for the live list. Notable cities include:

Alberta: Calgary, Edmonton, Red Deer, Lethbridge, Airdrie, Medicine Hat, Grande Prairie, Fort McMurray
BC: Vancouver, Surrey, Burnaby, Richmond, Kelowna, Abbotsford, Victoria, Coquitlam, Langley
Ontario: Toronto, Ottawa, Hamilton, London, Brampton, Mississauga, Barrie, Windsor, Kitchener, Ajax, Aurora
Quebec: Montreal (selected areas)
Prairie & Atlantic: Saskatoon, Regina, Winnipeg, Halifax, Moncton, Fredericton


API Reference


Support

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors