SkillHub

mcdonalds-mcp-order-lite

v1.0.0

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...

Sourced from ClawHub, Authored by danielliao

Installation

Please help me install the skill `mcdonalds-mcp-order-lite` from SkillHub official store. npx skills add danielliao/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

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.