mcd-diet-guard skill
A skill that scans McDonald's China menus via the official MCP and sorts dishes by your dietary restrictions, suggesting swaps.
- 120 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The official McDonald's MCP token can create orders, and allergen classification is approximate.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-diet-guardDetects 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 McDonald's MCP token can create orders, and allergen classification is approximate.
This is third-party code. Review the repository files before installing.
What it does
mcd-diet-guard reads a store's menu and each dish's details through the official McDonald's MCP and sorts items into safe, safe after modification, needs confirmation and not recommended. Fixable dishes get a modification such as removing bacon, and combos get an allowed swap with the smallest surcharge. There are 16 built-in profiles: no pork, no beef, vegetarian, vegan, allergies to seafood, eggs, milk, gluten, sesame, nuts and more, plus custom exclusions. A multi-person mode, a communication card for the cashier and a delivery note are included.
Who it is for. People with dietary restrictions and anyone ordering for friends and colleagues with different exclusions at McDonald's China.
Good fit when
- A friend avoids pork and you need to know what is safe in a combo at the nearest store.
- A pork-heavy breakfast needs substitutes without checking the menu item by item.
- An order for three, each with a different exclusion, needs dishes that suit everyone.
- A delivery needs a note up to 50 characters asking to remove an ingredient.
Not a fit when
- You need a guarantee for severe allergies: output rests on names and visible composition and cross-contact is not excluded.
- You need halal certification: the MCP does not provide it.
- You are outside China or have no McDonald's MCP token.
Example request
At the store near the square pick pork-free dishes, swap what is not allowed in the combos, price the order and show it before confirmation.Limitations
Classification rests on names and visible ingredients, not official allergen data, and ignores shared equipment or fryers. For severe allergies confirm with the restaurant. Creating or cancelling orders, coupons and points change your account, so the skill asks for explicit consent and you pay yourself via the link. Menus depend on time of day and store. The skill was written for a developer contest and targets the Chinese chain. Composition data comes from the MCP response, and if it changes the classification goes stale.
How to disable. Delete `skills/mcd-diet-guard` from the skills directory, remove the McDonald's MCP entry from the config and revoke the token in the open.mcd.cn console.
FAQ
Does the script place orders?
No. The script only fetches data, classifies dishes, builds parameters and prices them. The agent creates the order after you confirm.
Is a token required?
Yes, a McDonald's MCP token from the open.mcd.cn console, passed via `MCD_MCP_TOKEN`. Fixture-based test runs need no token.
Can I try it offline?
Yes, commands accept `--fixture` with sample data such as `tests/fixtures/store_sample.json`.
Which restrictions are built in?
Sixteen profiles: no pork or beef, vegetarian, vegan, allergies to seafood, eggs, milk, gluten, sesame and nuts, spicy and others.
What is the cashier card?
A short text with your restrictions to show staff when ordering in store, plus a delivery note up to 50 characters.
Discussion
No questions or reviews yet.
Related
SkillsMcButler (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 and CLI for the McDonald's China menu: three meal options for a budget, with nutrition and a source for every figure
A skill calculates daily calorie targets and builds three ready McDonald's China meal sets from the menu, with sodium warnings.
An unofficial skill for McDonald's China: a training plan, combo comparison by price and macros, order tracking and recaps
A skill that plans a China McDonald's order under a budget and sodium limit, checks store coupons and never orders.
CLI and skill for McDonald's China orders: pick a meal by calories, price it with coupons and hold the order until confirmed.
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| mcd-diet-guard (this card) | no | 120 | |
| mcd-nutrition-expert | no | 104 | evaluates nutrition of dishes; mcd-diet-guard excludes forbidden ingredients and swaps combo items |
| mcd-agent-gourmet | no | 148 | picks dishes by taste; here selection follows restrictions and allergies with composition modification |
README in short
The script uses only the Python 3.8+ standard library. All commands also output JSON via `--format json`, so results can be passed on.