mcdonald

McDonald's China MCP

This is an unofficial personal integration connecting to the official McDonald's China MCP service, for non-commercial use only. It can read stores, menus, coupons, points, nutrition, and orders, and can also actually create orders, redeem points, claim coupons, and write addresses. Prefer using the already loaded mcd-mcp tools; if MCP is disabled, not loaded, or the shared backend has not inherited the environment variables, use this skill's CLI fallback directly. First determine whether the operation will cause external state changes.

Using local commands

Optional global mcd command can be executed from any directory. The command only reads the Bearer token from the environment variable MCD_MCP_TOKEN , and does not display or save it. If no global symlink has been created or PATH is unavailable, please use the canonical relative fallback path SKILL.md in the Skill directory containing this ./scripts/mcd, or use the full path of that file.

mcd doctor
mcd tools
mcd schema query-meals
mcd call now-time-info --json

tools reads the live snapshot saved with the Skill by default;--live queries online;--check compares the snapshot with online;--sync will only atomically update the snapshot when online is still the same approved 24 tool names. Tool additions, deletions, or renames will cause sync to be rejected, and the local approved set must be reviewed and updated first.schema TOOL [--live] outputs the complete tool contract.call TOOL [JSON_ARGS] displays the service's raw Markdown envelope by default,--json extracts the structured business JSON within it.

Security boundaries

1. create-order、mall-create-order、auto-bind-coupons、delivery-create-address are all write operations. Only after the user explicitly confirms may --confirm-writebe appended, otherwise the command must refuse before going online.
2. Before creating a food ordering order, first execute calculate-price; repeat back to the user item by item the store, food items, quantities, coupons used, and amount payable, and only after obtaining one explicit confirmation may create-order --confirm-write。
3. do not fabricate storeCode、beCode、productCode、couponId、takeWayCode or gmServiceCode; they must come from the previous step's response.
4. Addresses, phone numbers, coupon codes, and payment links are used only in the current session and are not written to files, Vault, or logs.
5. HTTP 200 does not mean business success. Within the response success:false is still a failure, and the command will return a non-zero status.

Key conventions

Scenario	beType	orderType	beCode	Also pass in
In-store pickup	1	1	do not pass	takeWayCode
McDelivery	2	2	must pass	addressId
Drive-thru	5	1	must pass	takeWayCode
Corporate group meals	6	2	must pass	addressId、gmServiceCode

Only pass for reservations reservationDate（yyyy-MM-dd HH:mm), and subsequent menus, food item details, available coupons, pricing, and ordering must all use the same value.calculate-price amounts are in cents; divide by 100 when showing to the user; order query and order creation amounts are yuan strings. For combo or single-item customized selectedKey / unselectedKey rules, see tools.md。

Shortest business flow

• In-store pickup:query-nearby-stores → query-meals → calculate-price → confirm → create-order → deliver payH5Url。
• McDelivery:delivery-query-addresses → delivery-query-stores → query-meals → calculate-price → confirm → create-order → deliver payH5Url。
• Drive-thru: follow the in-store pickup flow, but continuously carry it starting from the store response beCode。
• Corporate group meals: follow the McDelivery flow, and before pricing add query-meal-assistance, passing the selected gmServiceCode to pricing and ordering.
• Points redemption:query-my-account → mall-points-products → mall-product-detail → confirm → mall-create-order; create each item separately and wait for the previous transaction's response.

Reference

• onboarding.md: Applying for a token, temporary injection, password managers, and handling when MCP is unavailable.
• workflows.md: The purposes and complete business processes of all 24 tools.
• tools.md: Parameter passing, amounts, customization, and display rules.
• troubleshooting.md: Authentication, protocols, rate limiting, and business failure diagnosis.
• tools.json: Complete input/output schemas and descriptions from the live tools/list .