mcdonalds-mcp-order-lite_skill

Overview

This skill places McDonald's China delivery orders through the official MCP server (https://mcp.mcd.cn) using a Bearer MCP token and Streamable HTTP / JSON-RPC. It provides address resolution, store/menu browsing, meal inspection, price calculation, order creation, and post-payment order query. The lite package contains only core reusable files and intentionally ships without an embedded token.

How this skill works

The skill calls MCP RPC endpoints in a fixed sequence: resolve delivery addresses, pick a store and query its menu, inspect meal details if needed, calculate the final price, and create the order after explicit user confirmation. It returns the payH5Url for payment and then polls query-order after the user confirms payment. All requests use Authorization: Bearer <TOKEN> and the MCP server URL https://mcp.mcd.cn with protocol version 2025-06-18 or earlier.

When to use it

• When a user wants to browse deliverable addresses and select where to deliver
• When querying a store's menu, individual meal or combo details
• When you need an accurate payable total before placing a delivery order
• When creating a delivery order and returning the payment link (payH5Url)
• When integrating MCP ordering into an agent client (Cursor, Cherry Studio, Trae, etc.)

Best practices

• Always call delivery-query-addresses first and use addressId, storeCode, and beCode from the returned record
• Never invent storeCode, beCode, or addressId — use values from delivery-query-addresses or delivery-create-address
• Always run calculate-price immediately before create-order and present the payable amount for user confirmation
• Respect MCP rate limits (target well under 600 requests/minute/token) and prefer low request volume
• Use server URL https://mcp.mcd.cn and include Authorization: Bearer <TOKEN>; keep protocol version <= 2025-06-18
• Avoid replacing default combo choices; query-meal-detail notes custom combo replacement is not supported yet

Example use cases

• Resolve user delivery address, find nearby McDonald’s, show top 3 meals and their real payable totals
• Inspect a combo via query-meal-detail and then calculate-price for a concrete selection before ordering
• Create a delivery order, return the payH5Url, then poll query-order after the user confirms payment
• Wire the MCP client wrapper into an agent UI so the agent can perform deterministic RPC calls
• Claim or list coupons and check user points before building a priced order