mcd-coupon-assistant skill
A WorkBuddy skill that queries stores and coupons through McDonald's China's official MCP and finds the cheapest meal combination.
- 115 ★ on the repository
- Last commit
Extended access
Why this level
- The official MCP token stays with the user and is sent to McDonald's.
- Writes (an order, claiming a coupon) happen only after confirmation.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-coupon-assistantDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The official MCP token stays with the user and is sent to McDonald's.
- Writes (an order, claiming a coupon) happen only after confirmation.
This is third-party code. Review the repository files before installing.
What it does
The skill walks the agent through a chain: find the nearest store, fetch coupons (`query-store-coupons`), assemble the menu, recalculate the price with `calculate-price` and show how much the best option saves. The local solver `references/coupon_solver.py` narrows the candidate combinations. Ordering and claiming coupons are off by default: any write needs explicit user confirmation. `references/coupon_price_guide.md` lists pitfalls, for example `couponId` comes only from `query-store-coupons` and `calculate-price` amounts are in fen.
Who it is for. WorkBuddy users in China who order from McDonald's and want to apply coupons for the biggest saving.
Good fit when
- Before ordering you want to compare which coupon pays off for a chosen set of dishes.
- You need to know which coupons are active in a specific store.
- Someone builds a multi-item order and asks how to pay less.
- An author builds a skill on McDonald's official MCP and wants a working sample.
Not a fit when
- You need to place orders automatically without confirmation.
- You have no China account and no MCP token.
- You need commercial use: the terms allow only personal non-commercial use.
Example request
Which coupon is the best deal for a Big Mac meal and spicy wings at the nearest store?Limitations
Works only with the official MCP `mcp.mcd.cn`; the token is issued at `open.mcd.cn/mcp` after phone login, with a limit of 600 requests per minute per token. Keep the token in `MCD_MCP_TOKEN`, not in the repository. The project terms allow personal non-commercial use and grant no rights to McDonald's trademarks. The skill is written for WorkBuddy; other clients need manual folder setup. Prices and coupons change, so verify the total in the restaurant app before paying.
How to disable. Delete the skill folder and the `mcd-mcp` connector from WorkBuddy and revoke the token in the McDonald's MCP console.
FAQ
Is a token required?
Yes. The MCP token is issued in the console at `open.mcd.cn/mcp` after phone login. Pass it through `MCD_MCP_TOKEN`.
Does the skill place orders itself?
No. Ordering and claiming coupons are off by default, and any write needs explicit user confirmation.
Where does couponId for the price call come from?
Only from `query-store-coupons`. `query-my-coupons` and `available-coupons` do not return it, so their data cannot go into `calculate-price`.
How can I try the solver alone?
Pipe JSON with items and coupons into `python references/coupon_solver.py`; the README has an example command.
Are there request limits?
Yes. A single token is limited to 600 requests per minute and the server answers 429 above that.
Discussion
No questions or reviews yet.
Related
SkillsA WorkBuddy skill reads McDonald's coupons and points through MCP and proposes up to two price-verified orders within a budget.
A skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.
A skill for the McDonald's China MCP: claims coupons, checks per restaurant which one redeems and computes the discounted price.
A McDonald's China MCP skill finds coupons and prices the cheapest order by budget or calories, ordering only on the user's word.
An agent skill that goes through McDonald's China menus and coupons and picks the lowest-priced order
Skill and CLI that compare the price of the same McDonald's China order: separately, combos, coupons, via official pricing.
README in short
The skill only compares prices and does not order. A detailed pitfall list lives in a reference file in the repository.