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.