McD Expiry Butler skill
A WorkBuddy skill reads McDonald's coupons and points through MCP and proposes up to two price-verified orders within a budget.
- 174 ★ on the repository
- Last commit
Extended access
Why this level
- The skill uses an official MCP token that gives read access to your account and the token lives in a local settings file.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-expiry-butlerDetects 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 skill uses an official MCP token that gives read access to your account and the token lives in a local settings file.
This is third-party code. Review the repository files before installing.
What it does
McD Expiry Butler works on top of McDonald's official MCP in China. It only reads coupons and points, shows which are about to expire and picks at most two orders within a budget. Each option's total goes through the official `calculate-price` calculation. When no option fits, the skill says to skip it this time. Budget outranks expiring perks. The skill first clarifies three things: budget, pickup method and restaurant. Then it filters coupons by restaurant and channel, computes the expiry window (7 days by default, adjustable), outputs a recommendation, a list of things not worth using and unconfirmed conditions. Points and cash are shown separately with no conversion rate. The result is built into a one-page HTML report. A demo mode on sample data exists for checking.
Who it is for. WorkBuddy users in China who collect McDonald's coupons and want to spend within a budget rather than because of an expiry deadline.
Good fit when
- The wallet has piled-up coupons and you need to know which expire soon and whether they are worth using.
- One order of 30 yuan is planned for the week and two price-verified options are needed.
- The restaurant and pickup channel restrict coupons and only usable ones should remain.
- A developer wants an example skill on an official MCP with price verification and tests.
Not a fit when
- You need to place an order, claim a coupon or pay: the skill does not perform those actions.
- You are outside China or without access to McDonald's MCP: the service and token come from a Chinese portal.
- You need points converted to money: the skill does not convert them.
Example request
I will eat at McDonald's once this week with a budget of 30 yuan. Show which coupons expire soon and whether they are worth using.Limitations
The skill targets WorkBuddy and McDonald's official MCP in China: you need a token from the `open.mcd.cn` portal activated by phone number. The token goes into `~/.workbuddy/mcp.json` by hand, the template holds only a placeholder and the file with the token must not be committed. After setup the service must be trusted in the connector manager and WorkBuddy restarted. Python 3.9 or newer is needed and there are no external packages. The skill does not create orders, claim coupons or pay. Do not print or publish the token.
How to disable. Rerun `bash scripts/install_skill.sh` to update. To remove, delete the `mcd-expiry-butler` folder from `~/.workbuddy/skills` and the `mcd-mcp` entry from `~/.workbuddy/mcp.json`.
FAQ
How do I install McD Expiry Butler?
Run `bash scripts/install_skill.sh` from the repository clone and the skill appears in `~/.workbuddy/skills/mcd-expiry-butler`. The `--project` key installs it into the current project. Rerunning updates.
Which MCP does the skill need?
McDonald's official MCP at `https://mcp.mcd.cn/mcp-servers/mcd-mcp`. The token is activated on `open.mcd.cn` by phone and entered into WorkBuddy `mcp.json`.
Does the skill order food itself?
No. It only reads coupons and points and computes prices. Claiming coupons, ordering, cancelling, paying and changing an address are out of the first version.
What happens if price calculation fails?
The skill shows the failure and does not estimate the total itself. A missing expiry is marked as expiry information not provided and coupon compatibility is not assumed.
Can I test the skill without an account?
Yes, the `python3 scripts/run_demo.py` demo mode builds a page on sample data with a clear note that it is not real account data.
Discussion
No questions or reviews yet.
Related
SkillsA skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.
A skill that plans a China McDonald's order under a budget and sodium limit, checks store coupons and never orders.
A WorkBuddy skill that queries stores and coupons through McDonald's China's official MCP and finds the cheapest meal combination.
McButler (mcd-self-butler)
mcd-self-butler
McButler works out calories and the full cost of an order, including travel and queue time, from the McDonald's China MCP
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
Overtime Meal Buddy
overtime-meal-buddy
A WorkBuddy skill that parses chat wishes, checks the McDonald's China menu through MCP and splits the bill for a group order.
README in short
The project was made for a WorkBuddy and McDonald's MCP contest. The repository has 17 logic tests, real run records and a demo page export.