McLottery Alchemist skill
A WorkBuddy skill for the McDonald's MCP: it computes coupons and points, assembles orders and guards draws with a ledger.
- 118 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- An agent can place orders and spend points under the account owner's token.
- The MCP token grants account access and belongs only in connector settings.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mclottery-alchemistDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- An agent can place orders and spend points under the account owner's token.
- The MCP token grants account access and belongs only in connector settings.
This is third-party code. Review the repository files before installing.
What it does
The skill sits on top of the 33 tools of the official McDonald's MCP server and splits the work into three layers. The skill reads a request and picks a module: ordering, coupons, nutrition, savings plan. A deterministic Python layer calculates when points expire, picks the best coupon, compares prices with and without it, builds meals for a calorie target and checks the order total. The MCP itself handles stores, menu, orders, coupons, points and draws. The repository also holds a draw ledger: intent, explicit consent, a single action, a freeze on unknown status and reconciliation. A demo page works offline without a token, and a reference covers API pitfalls, for example zero points on an item does not mean it is free.
Who it is for. Regular McDonald's customers in China who want an agent to calculate coupons and points rather than guess.
Good fit when
- Points will expire soon and you need to know what to redeem.
- Before ordering, compare which coupon gives the lowest final price.
- Meals are assembled for a given calorie target.
- A developer studies McDonald's MCP responses and takes the ready reference.
Not a fit when
- A service outside China is needed: the MCP and promotions work only there.
- The MCP token would be handed to an agent without confirming each order.
- A guaranteed win in a draw is expected.
Example request
Show my points and coupons, propose the cheapest 700 kcal order and ask for confirmation before checkout.Limitations
The skill targets WorkBuddy and the Chinese McDonald's MCP, with Chinese documentation. Real actions need a token from the MCP console, and calculations plus the draw ledger need the package installed on Python 3.10 or newer. Copying only the skill folder gives read-only queries and entertainment, without the draw guard. The ledger defaults to `~/.mclottery/ledger.jsonl`. API responses carry monthly expiry totals rather than exact dates, so the skill never names dates. The last commit dates from October 2026.
How to disable. Disable the `mcd-mcp` connector in WorkBuddy, remove the skill folder and run `pip uninstall` on the package. Delete `~/.mclottery/ledger.jsonl` manually after reconciling open draws.
FAQ
Is a token needed to try it?
No. The demo page works offline, without a token and without spending points.
What does the draw ledger do?
It records intent and consent, performs a single action and, when status is unknown, freezes further attempts until reconciliation.
Does the skill raise the chance of winning?
No. The entertainment modes are explicitly marked as not affecting probability.
Why do zero points not mean free?
The points store includes paid events with zero points and a cash price. The skill filters such items out.
Which agents are supported?
The documentation describes WorkBuddy. The skill format is standard, but connecting other agents is not documented by the author.
Discussion
No questions or reviews yet.
Related
SkillsA WorkBuddy skill over the McDonald's MCP that ranks coupons and points by urgency and checks prices against the server.
A 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 WorkBuddy skill that totals the calories in a month of McDonald's orders and assembles a healthier next lunch.
A skill that guides an agent through the 35 McDonald's China MCP tools: coupons, orders, delivery, lottery and points.
A McDonald's China MCP skill finds coupons and prices the cheapest order by budget or calories, ordering only on the user's word.
README in short
The repository separates request understanding, calculation and MCP calls. For developers it documents real API responses and the traps in them.