McD Saver skill

Skill and CLI that name the cheapest way to order food at McDonald's China and show the outcome before an order is created

  • 134 ★ on the repository
  • Last commit
Skill

Broad access

Why this level

  • The MCP token opens a McDonald's account with coupons and points, and the tools can create an order
  • An order needs your confirmation, but a mistaken confirmation spends money and points
All reasons and checks

yuxinlaile/mcd-saver

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mcd-saver

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The MCP token opens a McDonald's account with coupons and points, and the tools can create an order
  • An order needs your confirmation, but a mistaken confirmation spends money and points

This is third-party code. Review the repository files before installing.

What it does

An assistant to run before ordering at McDonald's China. The skill follows four steps: claim available coupons, pick the best one for the order, compare the price without and with the coupon through the official `calculate-price` tool and check whether paying with points is cheaper. The result shows the original price, discount, amount payable and share saved. The repository offers three ways to work: `SKILL.md` for Claude Code, Cursor and Codex, a standalone CLI `scripts/mcd.py` that talks to the official `M-China/mcd-mcp-server`, and a no-login trial page. The `optimizer.py` optimiser enumerates plain, coupon, top-up to threshold and set-swap options and ranks them, with limits for budget, calories, protein and sodium.

Who it is for. Mainland China residents who order from McDonald's often and want to pay less through coupons, group-buy offers and points.

Good fit when

  • Before ordering you want the real price with every available coupon and compare it with the face value of a coupon pack
  • Coupons from Meituan and Douyin sit unused and need comparing with official ones alongside points
  • The order must fit a budget, calorie or protein limit and you need a fitting set
  • You want to test the logic with no token: the offline demo `python demo.py` runs the whole path

Not a fit when

  • You are outside mainland China: the MCP token needs a mainland China phone number
  • You want another restaurant or country: the skill knows only McDonald's China
  • You want automatic daily coupon claiming: `claim` runs by hand on confirmation

Example request

Work out how to order two Big Macs and fries at McDonald's for less, with coupons or points, and do not create an order without my confirmation

Limitations

  • An MCP token from the McDonald's China open platform is required, and phone login is for mainland China only.
  • Python 3.9 or newer works with no third-party packages to run; tests need `pytest` and `pytest-cov`.
  • An order is created only after your confirmation, and payment happens on the official McDonald's page.
  • Meituan and Douyin group-buy prices are estimated from data you supply, and an official calculation exists for coupons only.
  • Documentation is in Chinese, with an English version in `README_EN.md`.

How to disable. Delete `~/.claude/skills/mcd-saver` or `~/.cursor/skills/mcd-saver`, remove the MCP entry from the client configuration and the `~/.mcd_mcp_token` file if you created one.

FAQ

How do I get an MCP token?

Log in to the McDonald's China open platform by phone, open the console, activate the service and copy the token. Put it in `MCD_MCP_TOKEN` or in `~/.mcd_mcp_token`.

How can I try it without a token?

Clone the repository and run `python demo.py`, an offline demo that goes from coupons to points. An online calculator page needs no login either.

Does the skill place an order by itself?

No. An order is created only after your explicit confirmation, and payment happens on the official McDonald's page.

What is the top-up trap?

Adding items to reach a coupon threshold that makes the total higher. The optimiser takes the no-top-up order as baseline and highlights such cases.

Which clients are supported?

The skill targets WorkBuddy, Claude Code, Cursor and Codex. Without a client the `scripts/mcd.py` CLI works.

Discussion

No questions or reviews yet.

Skills

Skill and CLI that compare the price of the same McDonald's China order: separately, combos, coupons, via official pricing.

SkillExtended access95Repository stars

An agent skill that goes through McDonald's China menus and coupons and picks the lowest-priced order

SkillBroad access1.3KRepository stars

A McDonald's China MCP skill finds coupons and prices the cheapest order by budget or calories, ordering only on the user's word.

SkillExtended access418Repository stars

Picks a McDonald's China order for budget, calories, party size and restrictions, claiming coupons first and verifying prices.

SkillExtended access111Repository stars

A skill on the McDonald's China MCP: turns a budget and wishes into up to three menus with official prices, leftover budget and coupon terms

SkillExtended access1.3KRepository stars

README in short

The Chinese README explains the principle: no order is created until four checks pass. Three install routes, a command table, a channel comparison example, the project layout and the list of MCP tools follow.

README badge

Report a problem