mcd-gacha-collector skill
A skill that turns the McDonald's China menu into collectible cards with price and calories; a drawn dish can be ordered via MCP.
- 125 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- Real orders with a payment link are created through the MCP, so a confirmation mistake means real spending.
- The MCP token grants access to the service account and is stored on your machine.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-gacha-collectorDetects 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.
- Real orders with a payment link are created through the MCP, so a confirmation mistake means real spending.
- The MCP token grants access to the service account and is stored on your machine.
This is third-party code. Review the repository files before installing.
What it does
The `mcd-gacha-collector` skill builds on McDonald's China's official MCP. It leads a newcomer through three stages: connecting the MCP, picking the nearest restaurant by address, and choosing budget and number of draws. It then pulls that restaurant's menu prices and nutrition data, scores healthiness and sorts dishes into SSR, UR and R rarities. The draw runs in the `gacha.py` script with weighted randomness rather than in the model. The agent shows the card, keeps a collection in `ledger.json` and, after confirmation, places a real order via `create-order`. The game is free: limited points restore every four hours.
Who it is for. MCP contest participants and experimenters who want a sample game skill on top of a real food service API, with the token kept on their own machine.
Good fit when
- You want a sample skill where a script does the math and the agent only narrates and asks.
- You are curious to play a collection game on dishes and compare calories and protein.
- A drawn card should become a real order after the price is confirmed.
- The card mechanics script must run without a token on bundled data.
Not a fit when
- You are outside mainland China: menus, store lookup and the MCP belong to McDonald's China.
- You need dietary advice: the author calls it entertainment, not guidance.
- The agent must never be able to place an order in your name.
Example request
Play with a 50-yuan budget: find the nearest restaurant, draw one card and show price, calories and rarity, but do not place an order.Limitations
It needs a token from the open.mcd.cn platform and a connected MCP, and the skill targets WorkBuddy, so other agents need manual setup. Menus, prices and restaurants are available only in China. The author notes this is an unofficial contest entry. Interface and documentation are in Chinese. The token stays on your machine: do not paste it into other chats. The online site version orders nothing and does not locate restaurants.
How to disable. Delete the `mcd-gacha-collector` folder from the skills directory (`~/.workbuddy/skills/`), disable the MCP connector and revoke the token in the open.mcd.cn console.
FAQ
Where do I get the token?
On open.mcd.cn/mcp: sign in with a phone number, then activate and copy the token in the console.
Can I try it without a token?
Yes. In the `scripts` folder, `python gacha.py sample_data --draw 1 --budget 50` runs draws on bundled data.
How is an order placed?
The agent checks the price via the MCP, shows it and waits for your confirmation. Only then is `create-order` called and a payment link returned.
Who computes rarity?
The `gacha.py` script. The skill forbids the agent from computing health, rarity or draw results itself.
Is there a web version?
Yes, a demo page shows cards with effects. Restaurant lookup and ordering are disabled there for privacy.
Discussion
No questions or reviews yet.
Related
SkillsA skill that reads McDonald's China points through MCP, filters fake mall listings and calculates the points-to-yuan value.
A CLI and skill for McDonald's China that finds the cheapest coupon and points payment; the agent orders after your yes.
A WorkBuddy skill that collects a team McDonald's China order by link and shows how much is missing for the discount.
A skill on McDonald's China's official MCP that finds nearby chain events and draws a cartoon map of verified sessions only
Binggo MCP дает агенту управлять локальным помощником по розыгрышам Bilibili: вход по QR, список акций, автоучастие.
A CLI and MCP server for China's Xianyu marketplace: publish items, handle chats and search through commands and five skills
README in short
The README details setup, project layout, the agent-to-MCP flow and tests (105 for the skill and 99 for parity with the web version). The author stresses that it is a game, not nutrition advice.