McDonald's Party Officer

Before you start: read this whole install prompt, tell me in a few lines what this skill does and what installing it involves, and wait for my go-ahead before you do anything else. Prerequisites: Account and token required before any real use: a McDonald's China MCP token. The listing is free, and activating the token is described upstream as free. Get the token yourself, in person, because it needs mobile phone number verification: go to https://open.mcd.cn/mcp , sign in with your mobile phone number, open the console at the top right, click Activate, agree to the service agreement, and copy the token. Then configure the McDonald's China MCP server: name mcd-mcp, type streamablehttp, URL https://mcp.mcd.cn , header Authorization: Bearer <your token>, or set the MCD_MCP_TOKEN environment variable where the skill reads it that way. Keep the token only in your own private client configuration or environment: never commit it, never share it, and never paste it into a shared chat. Upstream states a limit of 600 requests per minute per token (429 above that). You also need Python 3.7 or later, with zero third party dependencies. One upstream warning to ignore: the upstream README suggests pasting the copied token into the conversation. Do not do that. Put the token only in your own environment variable or private connector configuration, exactly as above, and never into a shared chat. Install "McDonald's Party Officer" for me. It scans McDonald's China party sessions by city, scores formation chances, compares private hire with group buy, picks dates against the official campaign calendar, audits kids nutrition, and books only after your explicit confirmation. Repository: https://github.com/yzg1226/mcd-party-officer (the skill is the whole repository at the pinned commit, SKILL.md at its root: 22 files, listed in the fingerprints below) Pinned version: install the code at commit f99dec02e33d611b4d7e690fcc7d6a02ed101e4d exactly. Do not substitute a newer version. If this commit is unreachable, stop and tell me. 1. Clone https://github.com/yzg1226/mcd-party-officer into a temporary folder, check out commit f99dec02e33d611b4d7e690fcc7d6a02ed101e4d, and copy the whole repository folder from that checkout, excluding the .git folder. Then compare every file in the folder with the fingerprints recorded for this listing on 2026-10-18: [FINGERPRINTS] - .gitattributes: SHA-256 8867bd68ea4ea2b82abab24c003ea6ee60dfbfd7ffcb8bb80bf1674202f48368 - .gitignore: SHA-256 86a0df0f2dea262bf7bef1237e116a0d40f31af960474fc341ac966591ffffbc - CONTEST_DECLARATION.md: SHA-256 cd28101bcb29cc8fb24b372fe91ce6b42c4a1487a54e01f7ade0c8c6a84241b7 - LICENSE: SHA-256 6e9f71a6df311b31e90b78c032d35e1336836b1ed5a440f4c60c4ea01f2961db - MCP_INTEGRATION.md: SHA-256 42c4663ee143c9714fcff292f86c7d04a515f797105dd49ffb497515f55b72d7 - README.md: SHA-256 31b109bbca2ed43e731e5887bce435ed4aa2ce3741b7694cd78e3066eb00e6b3 - SKILL.md: SHA-256 aa7e95cfde7178e95ca49ea90622ad9f24c996237ead20041b930ac99c8c5255 - docs/index.html: SHA-256 1c43f227326b5e581c5af972f90c4eeed3009550161489ef074af51556e708b6 - docs/preview-1-output.png: SHA-256 22d9ef072e96b83c06d45369880e52d836301c75fac84f427f4a44459c721f00 - docs/preview-2-recruit-card.png: SHA-256 7c8470540fb2c75fa90973f9aa4b279551d96e4bebe053f1cae357e7e889f3a6 - docs/preview-3-invite.png: SHA-256 ea0a0f8f50b534547d12d5c6470a5f29fc94a9231357fe65af18e518f5ba3d3f - examples/sample_invite.html: SHA-256 407f93cc24849b3e052b2d2e2c5ad5ed5273eb4af7f97ecd8e9b39361d850d02 - mcp-config.example.json: SHA-256 7644e429708a6aa8ceb09505dcd0fc9a092b3608e974767360f4c158cb1047dd - references/creative_modules.md: SHA-256 cd671ef9cf6417d08e35cee2acf564e5912d5b1cc7b98079206cf6d35d868f0b - references/party_flow.md: SHA-256 a74d99f345d7584e605053e2c9c0f58779b0c3113af28ecf2d79c24d20d75bf8 - references/tools.md: SHA-256 545dfb92a11735a2f1deae832afc90d57cd444a1ab89591916f7574a260c5b08 - scripts/demo.py: SHA-256 e917b6f3ae1a7c3fddfeb5152a32dc5020d8855c524389853ffb15f8d8301719 - scripts/demo_plus.py: SHA-256 6e65c0adb0446fbfc266de8d8c2fccc54b08ec0575d5b8b9375a5f1d5367f1b8 - scripts/mcd_client.py: SHA-256 7897a0ab78dbf7780cc0305c8c5917b0d99b2bf284ac8d1a6bc8451a34d50926 - scripts/party_officer.py: SHA-256 cb6d36c666594fd81986cff3e5683cb9430a094f2848b980c5b7959f4d1ece27 - scripts/party_plus.py: SHA-256 11c9fa5c14c6e94cb8af771cf8b7b31a34e405a78ba111a6f7080c5ee18367a2 - workbuddy.md: SHA-256 4ca2f6460eef62069687ea7182d22d82db26dc19808dd0b4b2a3bd5682d3bdae If a file does not match, it changed since the listing was prepared: do not install it yet, tell me what you found and let me decide. 2. Read SKILL.md in full (and every other file in the folder) and tell me in plain words: what the skill does when used, which services it connects to, whether it reads or sends any personal information or keys, and anything that seems unusual. Stop on any red flag and tell me before going further. Confirm these points from the files: - The skill is the whole repository at the pinned commit (SKILL.md at the root): scripts/ (mcd_client.py, party_officer.py, party_plus.py, demo.py, demo_plus.py), references/ (tools.md, party_flow.md, creative_modules.md), examples/sample_invite.html, docs/ (a static demo page and preview images), mcp-config.example.json, MCP_INTEGRATION.md, README.md and workbuddy.md. All Python is standard library only, and the creative modules are pure local computation on official data. - At use time, the only network destination in the code is https://mcp.mcd.cn (Streamable HTTP POST, Authorization: Bearer token read from the MCD_MCP_TOKEN or MCDONALDS_MCP_TOKEN environment variable). The calls send: mall-points-products with a category path (catRuleIds) to find the party product and its spuId; mall-product-detail with that spuId; query-party-city with the spuId; query-party-store with the city code, the spuId, and the latitude and longitude that the server itself returned for that city; query-party-store-date and query-party-store-session with spuId, storeCode and date; campaign-calendar and list-nutrition-foods for the almanac and the kids nutrition audit. So the server receives your token, the city level coordinates it issued, your chosen stores, dates and session identifiers, and your headcount where a function needs it, and it returns session availability, prices, the campaign calendar and nutrition tables to your machine. Recruit cards and invitation HTML are generated locally. The GitHub Pages demo link and the badge images in the README and docs/ are documents only; the scripts call no host other than mcp.mcd.cn. - Booking is the only write: party-order-create, called only after your explicit confirmation, with partyType (1 private hire, 2 group buy), spuId, skuId, storeCode, the city code, dateStr, the session id, leftNum and count (your headcount). The SKILL.md forbids calling it without that confirmation. Group buy carries the official risk the skill must tell you about: if the group does not form by the deadline, the booking is automatically cancelled and refunded; cancelling a formed booking needs a request 3 days before the event, and same day absence is not refunded. The kids nutrition module compares a menu against hard coded reference ranges for one kids meal (calories 400 to 700 kcal, sodium at most 800 mg, fat at most 26 g) and must present them as reference values, not official conclusions. - Nothing is sent anywhere during installation itself; the only download at install time is the repository from GitHub at the pinned commit. The listing and the token are free; a party booking you confirm is paid through McDonald's under its own terms. 3. When I say "yes, install", install it as a skill: copy the whole folder into the agent's skills directory, in a folder named "mcd-party-officer", keeping every file listed in the fingerprints above. 4. Verify with no network calls: frontmatter valid, files in place. 5. Report what was installed, where, and what I still need to do myself (for example: get the McDonald's China MCP token myself at https://open.mcd.cn/mcp with my mobile phone number if I do not have one, put it only in my own private MCP client configuration or environment variable and never paste it into a shared chat, install Python if it is missing, and set up the mcd-mcp connector to https://mcp.mcd.cn if it is not configured; using the skill is a separate step that only starts when I ask for it, and any order, coupon claim or booking happens only as disclosed above). GitHub is optional: if I have a GitHub account or the gh CLI, you may use it; otherwise public access is fine. Never require it unless it's in the prerequisites above. Rules: don't touch anything outside the temp folder and the install target. If anything looks off, stop and ask me.