# Mcdonalds MCP Order Lite

> Place McDonald's China delivery orders through the official MCP server at https://mcp.mcd.cn using a Bearer MCP token over Streamable HTTP / JSON-RPC. Use when the user wants to browse McDonald's deliverable addresses, query store menu items, inspect meal details, calculate price, create a delivery order, query order status, or check McDonald's coupons/points. Also use when wiring this MCP into a client like Cursor, Cherry Studio, Trae, or another agent. This lite package intentionally contains no embedded token and only the core reusable files.

- Skill: `dvcrn/mcdonalds-mcp-order-lite` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add dvcrn/mcdonalds-mcp-order-lite`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/mcdonalds-mcp-order-lite/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/mcdonalds-mcp-order-lite

---


Use the official McDonald's China MCP toolchain, not scraped web APIs.

## Core workflow

1. Identify the delivery address.
2. Call `delivery-query-addresses` first.
3. Pick the matching address record and carry forward `addressId`, `storeCode`, and `beCode` from the same record.
4. Call `query-meals` for that store.
5. If needed, call `query-meal-detail` for a chosen meal code.
6. Call `calculate-price` before ordering.
7. Show the user the real payable amount and wait for confirmation.
8. Call `create-order` only after confirmation.
9. Return the `payH5Url` to the user.
10. After the user says payment is complete, call `query-order`.

## Important constraints

- Use server URL `https://mcp.mcd.cn`.
- Send `Authorization: Bearer <TOKEN>`.
- MCP protocol version must be `2025-06-18` or earlier.
- Prefer low request volume; the docs say 600 requests/minute/token.
- Do not invent `storeCode`, `beCode`, or `addressId`.
- For delivery ordering, always use values returned by `delivery-query-addresses` or `delivery-create-address`.
- Always price-check with `calculate-price` before `create-order`.
- `query-meal-detail` docs note that replacing default combo choices is not yet supported in current version.

## Tool map

### Delivery ordering
- `delivery-query-addresses`: list saved deliverable addresses
- `delivery-create-address`: add a new delivery address
- `query-store-coupons`: coupons usable for the chosen store
- `query-meals`: menu for the chosen store
- `query-meal-detail`: inspect a meal / combo
- `calculate-price`: final price check
- `create-order`: create payable delivery order
- `query-order`: query order status after creation/payment

### Other useful tools
- `available-coupons`: claimable coupons
- `auto-bind-coupons`: one-click claim current coupons
- `query-my-coupons`: coupon wallet
- `list-nutrition-foods`: nutrition list
- `query-my-account`: points account
- `mall-points-products`, `mall-product-detail`, `mall-create-order`: points mall
- `campaign-calendar`: marketing calendar
- `now-time-info`: server time

## Recommended user-facing flow

When the user says “帮我点麦当劳” or similar:

- Confirm budget / preferred item if missing.
- Resolve the delivery address from saved addresses first.
- Find candidate items from `query-meals`.
- Use `calculate-price` for one or a few concrete combinations.
- Present the cheapest / best-fit options with real payable totals.
- Only place the order after explicit confirmation.
- After order creation, send the payment link.
- After payment, query `query-order` instead of assuming success.

## Files in this skill

- Read `references/api.md` for the compact API cheat sheet and tested field names.
- Use `scripts/mcd_rpc.py` for direct RPC calls to the remote MCP server when you need deterministic testing or CLI usage.
- `client.py` contains a Python wrapper around the same remote MCP calls.
- `nlp_processor.py` contains lightweight text parsing for order intent.
- `tools.py` contains higher-level helper functions.

## Packaging notes

Keep the skill folder lean.
Do not add extra docs beyond what is needed for reuse.
Remove transient files like `__pycache__` before packaging.