{"skill":{"slug":"mcdonalds-mcp-order-lite","displayName":"mcdonalds-mcp-order-lite","summary":"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 wh...","description":"---\nname: mcdonalds-mcp-order-lite\ndescription: 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.\n---\n\nUse the official McDonald's China MCP toolchain, not scraped web APIs.\n\n## Core workflow\n\n1. Identify the delivery address.\n2. Call `delivery-query-addresses` first.\n3. Pick the matching address record and carry forward `addressId`, `storeCode`, and `beCode` from the same record.\n4. Call `query-meals` for that store.\n5. If needed, call `query-meal-detail` for a chosen meal code.\n6. Call `calculate-price` before ordering.\n7. Show the user the real payable amount and wait for confirmation.\n8. Call `create-order` only after confirmation.\n9. Return the `payH5Url` to the user.\n10. After the user says payment is complete, call `query-order`.\n\n## Important constraints\n\n- Use server URL `https://mcp.mcd.cn`.\n- Send `Authorization: Bearer <TOKEN>`.\n- MCP protocol version must be `2025-06-18` or earlier.\n- Prefer low request volume; the docs say 600 requests/minute/token.\n- Do not invent `storeCode`, `beCode`, or `addressId`.\n- For delivery ordering, always use values returned by `delivery-query-addresses` or `delivery-create-address`.\n- Always price-check with `calculate-price` before `create-order`.\n- `query-meal-detail` docs note that replacing default combo choices is not yet supported in current version.\n\n## Tool map\n\n### Delivery ordering\n- `delivery-query-addresses`: list saved deliverable addresses\n- `delivery-create-address`: add a new delivery address\n- `query-store-coupons`: coupons usable for the chosen store\n- `query-meals`: menu for the chosen store\n- `query-meal-detail`: inspect a meal / combo\n- `calculate-price`: final price check\n- `create-order`: create payable delivery order\n- `query-order`: query order status after creation/payment\n\n### Other useful tools\n- `available-coupons`: claimable coupons\n- `auto-bind-coupons`: one-click claim current coupons\n- `query-my-coupons`: coupon wallet\n- `list-nutrition-foods`: nutrition list\n- `query-my-account`: points account\n- `mall-points-products`, `mall-product-detail`, `mall-create-order`: points mall\n- `campaign-calendar`: marketing calendar\n- `now-time-info`: server time\n\n## Recommended user-facing flow\n\nWhen the user says “帮我点麦当劳” or similar:\n\n- Confirm budget / preferred item if missing.\n- Resolve the delivery address from saved addresses first.\n- Find candidate items from `query-meals`.\n- Use `calculate-price` for one or a few concrete combinations.\n- Present the cheapest / best-fit options with real payable totals.\n- Only place the order after explicit confirmation.\n- After order creation, send the payment link.\n- After payment, query `query-order` instead of assuming success.\n\n## Files in this skill\n\n- Read `references/api.md` for the compact API cheat sheet and tested field names.\n- Use `scripts/mcd_rpc.py` for direct RPC calls to the remote MCP server when you need deterministic testing or CLI usage.\n- `client.py` contains a Python wrapper around the same remote MCP calls.\n- `nlp_processor.py` contains lightweight text parsing for order intent.\n- `tools.py` contains higher-level helper functions.\n\n## Packaging notes\n\nKeep the skill folder lean.\nDo not add extra docs beyond what is needed for reuse.\nRemove transient files like `__pycache__` before packaging.\n","tags":{"latest":"1.0.0"},"stats":{"comments":1,"downloads":597,"installsAllTime":1,"installsCurrent":1,"stars":0,"versions":1},"createdAt":1773056183041,"updatedAt":1778491788483},"latestVersion":{"version":"1.0.0","createdAt":1773056183041,"changelog":"- Initial release of mcdonalds-mcp-order-lite for McDonald’s China delivery ordering via the official MCP server.\n- Supports browsing deliverable addresses, store menus, meal details, coupons, price calculation, and order creation/status.\n- Uses secure Bearer MCP token authentication; no embedded tokens included.\n- Designed for easy client integration with clear workflow documentation.\n- Lite package with only core reusable files and minimal dependencies.","license":"MIT-0"},"metadata":null,"owner":{"handle":"danielliao","userId":"s17fqgd9mggmvz3b6cwgn97jth83jqfs","displayName":"danielliao","image":"https://avatars.githubusercontent.com/u/3085195?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089812252}}