MCD Party Planner

zcbacxc/mcd-party-plannerReviewed by AI

What it does

You type a city, a neighbourhood, how many people and your budget, and this tool asks McDonald's China's official MCP service for nearby open stores, the real menu and the real price, then shows a few meal combinations with the total and the price per person. It can also look up birthday party slots and the campaign calendar. It works only with McDonald's China: you need a free token from open.mcd.cn (sign-in by Chinese phone number) and Python 3.9. It also runs as a WorkBuddy skill.

How easy it is to install

C · install 1 or 2 tools · Windows

You install Python 3.9, download the repository, request a token on open.mcd.cn and put it in a .env file, then run commands in the terminal; no extra packages are needed.

Numbers on GitHub

Stars: 1,596on Oct 31, 2026
Downloads: —all releases
Growth: —no gain in the last reading

Stars over time

Facts

Runs on: Windows, macOS, Linux
You need to install: Python
Disk space: not determined
Accounts or keys: McDonald's China MCP (MCD_MCP_TOKEN)
Cost: Free · The program is free and the McDonald's MCP token is free to request; the food and the party booking are of course paid.
License: MIT (Permissive)
Last update: Oct 27, 2026

Risk signals (5)

Attentioncan place a real paid booking
README.md: party booking is dry_run by default, and "python -m src.cli party --city 成都市 --headcount 6 --confirm" places a real order (example shows a ¥50.0 party slot).
AI review
Infoworks only in china
README.md and .env.example point to https://open.mcd.cn/mcp with sign-in by phone number, and every example uses Chinese cities; it talks to McDonald's China's service only.
AI review
Infosends your search to mcdonalds
README.md states city and keyword are sent to McDonald's MCP as query parameters, and that inputs stay in memory and are not written to disk.
AI review
Infonot an official product
README.md section 七: contest entry for McDonald's programmer-day contest, developed independently, "非麦当劳官方产品" (not an official McDonald's product).
AI review
Infovery new project
Project facts: repository created 2026-10-15, 7 releases by 2026-10-27, 1600 stars.
AI review

Evidence is shown in its original language.

What Radar could not check

Whether you can get a token without a Chinese phone number
Whether the commands run as shown on Windows
Whether the prices and store list match what you see in the McDonald's app on the day you run it
What exactly happens when you add --confirm and a real party order is created
Whether the offline replay snapshots in examples/ still match the current service