mcd-party-planner skill
This skill prices a real McDonald's group order by city, headcount and budget through the vendor's own official MCP.
- 1,382 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The `MCD_MCP_TOKEN` grants access to the vendor's official MCP and real order pricing on its side.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-party-plannerDetects 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 `MCD_MCP_TOKEN` grants access to the vendor's official MCP and real order pricing on its side.
This is third-party code. Review the repository files before installing.
What it does
mcd-party-planner is an agent skill built on McDonald's China's own official MCP: given a city, a location keyword, a headcount and a budget, it finds nearby open restaurants, pulls their real menu and prices several comparable group-order options through the vendor's own official pricing API. Results are not a demo: prices and menus come from a direct MCP call and change day to day, same as the real chain. The skill also links an order to a specific restaurant's themed-event schedule (parties, tastings) and suggests a good time to organize an outing, based on the activity calendar and nearby locations.
Who it is for. Organizers of group outings and family celebrations in China who want a quick McDonald's group-order cost estimate.
Good fit when
- A quick cost estimate is needed for several comparable McDonald's group-order options by budget and headcount.
- An outing ties to a specific restaurant's themed activity (a party, a tasting).
- Prices and menus need coming straight from the official API, not approximate reference data.
- A result needs to be offline-reproducible for a demo with no personal token.
Not a fit when
- A McDonald's MCP token (`MCD_MCP_TOKEN`) is unavailable and an offline snapshot replay does not fit the task.
- An order from a restaurant chain outside China is needed: the MCP and skill are built for the Chinese chain.
- Placing or paying for the order matters end to end: the skill only prices and compares options, not the purchase itself.
Example request
Chengdu, Chunxi Road area, 8 people, budget 400 yuan, find a few McDonald's group-order options.Limitations
A separately issued `MCD_MCP_TOKEN` for McDonald's China's official MCP is needed; it is free to request at `open.mcd.cn`. Without a token, only replay mode (`--replay`) works, against a previously saved real call snapshot: it sends no requests and suits a demo, not a current price. The server's menu and prices change day to day, so rerunning with the same parameters can give a different result; that is normal behavior for the real API, not a skill bug. The project was built for a McDonald's developer contest and is aimed at the Chinese market.
How to disable. Remove the skill from the agent's skills directory and delete the `.env` file holding the `MCD_MCP_TOKEN`.
FAQ
Where do I get an MCP token?
Free at `open.mcd.cn`, then set it as the `MCD_MCP_TOKEN` variable in the `.env` file.
Can I see a result without a token?
Yes, the `--replay` flag replays a saved snapshot of a real call with no requests sent.
Why does a rerun give a different price?
McDonald's menu and prices change day to day on the server, so the result can differ from a previous run; that is normal live-API behavior.
Does the skill connect to a restaurant's themed events?
Yes, it links an order to a specific restaurant's themed-activity schedule and suggests a good time for the outing.
Does the skill work outside China?
No, it is built on McDonald's China's official MCP and aimed at the Chinese restaurant chain.
Discussion
No questions or reviews yet.
Related
SkillsThe "Party Scout" skill uses McDonald's official MCP in China to find restaurants and open dates for a kids' party.
A skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.
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
Skill that prices a group McDonald's China order over MCP, compares service tiers and shows the gap to the next discount.
A WorkBuddy skill over the McDonald's MCP that ranks coupons and points by urgency and checks prices against the server.
McDonald's China ordering skill: picks a restaurant, asks party size and budget, offers three sets with price checks
README in short
The author shows real output from 20 October 2026: two scanned restaurants, six possible options, one fitting a 400-yuan budget at an average 42.8 yuan per person.