mcdonalds-mcp-order-lite麦当劳点餐助手

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

Core workflow

1. 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.
• INLINECODE20 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
• INLINECODE22: add a new delivery address
• INLINECODE23: coupons usable for the chosen store
• INLINECODE24: menu for the chosen store
• INLINECODE25: inspect a meal / combo
• INLINECODE26: final price check
• INLINECODE27: create payable delivery order
• INLINECODE28: query order status after creation/payment

Other useful tools

• - available-coupons: claimable coupons
• INLINECODE30: one-click claim current coupons
• INLINECODE31: coupon wallet
• INLINECODE32: nutrition list
• INLINECODE33: points account
• INLINECODE34, mall-product-detail, mall-create-order: points mall
• INLINECODE37: marketing calendar
• INLINECODE38: 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.
• INLINECODE44 contains a Python wrapper around the same remote MCP calls.
• INLINECODE45 contains lightweight text parsing for order intent.
• INLINECODE46 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.