MCD Party Scout skill
The "Party Scout" skill uses McDonald's official MCP in China to find restaurants and open dates for a kids' party.
- 103 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The skill reads data with the user's token and creates no orders or payments.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-party-scoutDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The skill reads data with the user's token and creates no orders or payments.
This is third-party code. Review the repository files before installing.
What it does
MCD Party Scout compresses the five-step check for McDonald's parties to two commands. The `party_scout.py` script uses only the Python standard library and works through McDonald's China official MCP server (`mcp.mcd.cn`), reading data only. The commands: `parties` lists all themes on sale with prices, `cities --spu` shows which cities offer a theme, `stores --spu --city --radius` lists restaurants that can host it, sorted by distance, and `slots --spu --store` shows dates, times, price, group size and remaining seats. Slots with three or fewer seats are flagged as tight. The author notes a party cannot be paid with points: all `point` fields of 26 themes were zero in the check, and prices ran 45 to 198 yuan per person.
Who it is for. Parents in China organizing a kids' party at McDonald's who want to quickly find the nearest restaurant with an open date.
Good fit when
- Which party themes exist and what they cost must be found.
- The cities and restaurants where a theme is available must be identified.
- Dates and remaining seats at a chosen restaurant need to be seen.
- Nearest restaurants need filtering by radius in kilometers.
Not a fit when
- An order must be placed or the party paid for.
- The country is not China.
- There is no way to get an MCP token from McDonald's.
Example request
Using party_scout show restaurants in Shenzhen within 5 kilometers that can host the theme 5224, and the open dates.Limitations
The script needs an MCP token from McDonald's China, issued on open.mcd.cn after phone number login, and the token goes in the `MCD_MCP_TOKEN` variable or the MCP configuration header. The skill only reads data and makes no orders, payments or bookings. Data depends on the official interface and may change, and every theme has its own list of cities and restaurants. The examples in the documentation are tied to China and written in Chinese.
How to disable. Remove the `MCD_MCP_TOKEN` variable and the `mcd-mcp` entry from the MCP configuration, then delete the skill folder. Revoke the token in the open.mcd.cn console if needed.
FAQ
How do I get a token?
At open.mcd.cn/mcp: phone login, then Console, Activate and copy the token.
Are dependencies needed?
No, the script uses only the Python standard library.
Does it place orders?
No, the skill only reads data and creates no orders or payments.
Can a party be paid with points?
Per the author's check no: the `point` value is zero for all 26 themes.
Why does the cities command matter?
Not every theme runs in every city, so without it the restaurant search may find nothing.
Discussion
No questions or reviews yet.
Related
SkillsThis skill prices a real McDonald's group order by city, headcount and budget through the vendor's own official MCP.
Picks a complete McDonald's China order for your budget and taste at official prices and returns a ready order card
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
A skill that plans a China McDonald's order under a budget and sodium limit, checks store coupons and never orders.
McDonald's China ordering skill: picks a restaurant, asks party size and budget, offers three sets with price checks
CLI and skill for McDonald's China orders: pick a meal by calories, price it with coupons and hold the order until confirmed.
README in short
A Python script compresses the McDonald's party check to two commands through the official MCP. Read-only, no orders.