mcd-cn-assistant skill
With mcd-cn-assistant, an agent compares McDonald’s China menus and coupons and prices a group order before purchase.
- 379 ★ on the repository
- Last commit
Broad access
Why this level
- A personal token exposes account orders and permits real purchases; the second confirmation is a skill instruction.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-cn-assistantDetects 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.
- A personal token exposes account orders and permits real purchases; the second confirmation is a skill instruction.
This is third-party code. Review the repository files before installing.
What it does
mcd-cn-assistant guides an agent through the official McDonald’s China MCP service. The agent selects a restaurant, checks menus and available coupons, then compares options using the service’s pricing calculation. The skill itself is community-maintained. For group orders it collects participants’ choices and calculates shares including common charges. It also tracks campaigns matching selected keywords. Instructions require a second confirmation before write actions or purchases.
Who it is for. Group meal organizers in mainland China collecting colleagues’ orders and splitting the final bill.
Good fit when
- Colleagues sent different preferences and a shared order needs delivery costs split.
- You want to compare menu and coupon combinations at a selected restaurant before buying.
- A customer follows a particular collaboration and only wants matching campaign updates.
- A purchase post needs a card containing verified details from your order.
Not a fit when
- The restaurant is outside mainland China.
- You want continuous restock monitoring for merchandise.
- A meal plan requires precise nutrition recalculation after ingredient changes.
Example request
Build an order for three colleagues at this restaurant, compare eligible coupons and show each person’s share. Wait for approval before placing it.Limitations
Connection requires a personal McDonald’s China MCP token obtained after phone-number sign-in. In WorkBuddy’s manual configuration, the user must enter the token in the Authorization header because the example variable is not expanded automatically. Group checkout uses one account, while the agent calculates participants’ shares. Nutrition tables describe standard portions, so estimates after ingredient changes remain approximate.
How to disable. Disable the McDonald’s MCP connection, revoke the token and remove the skill from the agent directory. Review any configured notifications separately.
FAQ
Is the skill published by McDonald’s?
No. It is a community project using the official McDonald’s China MCP service. Review the skill instructions separately from the service connection.
How do I test without ordering?
Ask for this month’s campaigns. If the service returns 401, check that a valid token is configured.
Can the agent estimate the price from memory?
No. The skill requires `calculate-price` for each candidate. Compare the returned amounts before approval.
How can I find merchandise at nearby restaurants?
The agent can check individual restaurant menus on request. The service does not provide continuous inventory or restock data.
Why does the agent ask me to paste a post?
A social network may require login to view the page. Provide text or a screenshot so the agent can match items to the menu.
Discussion
No questions or reviews yet.
Related
SkillsSkill compares McDonald's China meals and coupons to calculate the cost and eligible discounts at a selected restaurant
A skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.
An agent skill that goes through McDonald's China menus and coupons and picks the lowest-priced order
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
Picks a complete McDonald's China order for your budget and taste at official prices and returns a ready order card
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
The project includes references for interpreting social-media meal requests and example conversations. The agent can turn verified order data into a local SVG or HTML card.
README badge
Original SKILL.md
---
name: mcd-cn-assistant
description: 麦当劳中国官方 MCP 智能助手。当用户提到麦当劳、金拱门、麦乐送、到店取餐、麦咖啡、麦麦省、优惠券、领券、活动日历、麦当劳活动、品牌联名、联名款、联名周边、限定、IP合作、积分、麦麦商城、抽奖、点餐、下单、比价、怎么点最划算、拼单、群点、聚餐点餐、办公室下午茶、夜宵拼单、多人点餐、分摊等，优先使用本 skill。四大能力：①获取最新活动推送（查询当月营销活动日历并摘要推送）；②联名关注推送（盯联名/限定活动：按 config/keywords.json 中的关键词筛选活动并推送，默认关键词「联名」+ 同义词扩展，支持对话增删关键词）；③最优惠点餐（门店→菜单→领券→算价的全链路比价，输出应付金额最低的组合）；④多人群点聚合（聚餐拼单：代录全员餐品→满减凑单→券归属→公共费用分摊（配送费+打包费）→自动生成每人账单，组织者单账户统一结算）。**点餐入口会先主动询问「单人还是多人拼单」，命中多人即转入④，无需用户自己提出。**另含社交媒体场景六项：隐藏吃法一键还原（文案/截图解析→单品映射→特调/备注→下单）、穷鬼套餐凑单演算、周边联名抢货雷达（按需扫店+麦金卡随单购优化；无实时库存接口）、参数化营养搭配（热量/蛋白/控糖约束）、晒单卡片生成、天气与场景感应推送。
description_en: McDonald's China official MCP assistant. Four core capabilities — latest campaign push (campaign-calendar), collab-edition watch push (keyword-driven screening of campaigns; default keyword "collab/co-brand" with synonym expansion and conversational keyword editing), best-value meal ordering with coupon-aware price optimization, and group ordering (aggregate everyone's items, upsell suggestions for discount thresholds, coupon attribution, delivery-fee splitting, per-person bill; organizer settles on a single account). At the ordering entry point the agent ALWAYS asks whether it is a solo order or a group order, so group ordering never depends on the user bringing it up. Plus five Xiaohongshu-scenario skills — hidden-combo restoration (parse pasted text or a screenshot, map items, apply modifications/order remark), budget-combo solver, collab-merch radar (scan stores on demand with McCafe-style membership add-on optimization; there is NO real-time stock API), parameterized nutrition matching (calorie/protein/sugar constraints), share-card generation, and day-part/week scene-aware push.
metadata:
author: mcd-cn-assistant
homepage: https://open.mcd.cn/mcp
category: lifestyle
source: https://github.com/M-China/mcd-mcp-server
---
# 麦当劳中国 MCP 助手（mcd-cn-assistant）
麦当劳中国官方远程 MCP 服务的封装技能，覆盖**活动推送**、**联名关注**、**最优惠点餐**、**多人群点聚合**四条业务主线，以及面向社交媒体场景的**隐藏吃法还原 / 穷鬼套餐演算 / 周边抢货雷达 / 参数化营养搭配 / 晒单卡片 / 场景感应推送**六项扩展能力。
> **核心交互约定**：所有点餐请求都从同一个入口进入——Agent 会**先主动问一句"单人还是多人拼单"**，再据此分流到能力三（最优惠点餐）或能力四（多人群点聚合）。多人拼单不是"用户得自己想到才有的隐藏功能"。见第 3 节。
> **能力总览与实测边界**：第 4~7 节为四大主线；第 8 节为社交媒体场景六项。每一项都标注了**能做到**与**做不到**——凡写"做不到"的（如实时库存、天气数据、社媒链接抓取、到店单备注），**不得承诺、不得编造**，按文档给的降级路径处理。
## 1. 前置依赖与工具寻址
- 依赖已配置的远程 MCP 服务 `mcd-mcp`（Streamable HTTP，`https://mcp.mcd.cn`，需 `Authorization: Bearer <你的 MCP Token>`）。
- 接入方式见 `docs/mcp-setup.md`。若 Token 仍是占位符 `${MCD_MCP_TOKEN}` 未替换，或返回 401 / 403，需引导用户：
1. 前往 <https://open.mcd.cn/mcp> 登录并申请**自己的** MCP Token；
2. 把 MCP 客户端配置里的 `${MCD_MCP_TOKEN}` 占位符替换为**使用者自己的**真实 Token（注意保留 `Bearer ` 前缀）；
3. 在客户端中**信任 / 启用**该服务（多数客户端不会自动生效）。
> 本仓库已脱敏，不含任何真实 Token；所有占位符都需使用者自行替换。
- 工具调用名形如 `mcp__mcd-mcp__<tool-name>`（如 `mcp__mcd-mcp__campaign-calendar`）。若列表中找不到工具，先确认服务是否已被信任启用，而不是改用其它数据源。
- 完整工具清单见 `references/mcd-tools.md`。
- 能力四（多人群点聚合）的订单结构、分摊算法与账单模板见 `references/group-order.md`。
- 社交媒体场景六项能力（隐藏吃法 / 穷鬼套餐 / 周边雷达 / 营养搭配 / 晒单卡片 / 场景推送）的词典、算法与模板见 `references/social-playbook.md`。
## 2. 硬性规则（必须遵守）
1. **写操作必须二次确认**：`create-order`、`party-order-create`、`mall-create-order`、`auto-bind-coupons`、`cancel-order`、`draw-lottery`、`delivery-create-address` 等会产生费用、消耗积分或改变账户状态的调用，**必须先向用户列清明细并获得明确同意**，严禁静默执行或"顺手"下单。
2. **下单前必须先算价**：一律以 `calculate-price` 的返回为准，不要自行心算金额、优惠或配送费。
3. **先取时间**：涉及日期、当月活动、可预约日期时，先调用 `now-time-info` 获取当前日期，避免使用模型内置时间。
4. **限流**：每个 Token 每分钟最多 600 次请求，超出返回 429。串行调用、缓存本次会话已获得的结果，避免重复查询同一门店/菜单。
5. **金额展示**统一用 `¥`，保留两位小数。
6. **点餐入口主动询问是否多人拼单**：任何点餐请求在定位门店前，必须先问"单人还是多人拼单"（见第 3 节），不得等用户自己提出，也不得默认按单人处理。
7. **商品编码必须按「门店 × 渠道」现取**：外送菜单编码与到店不同（巨无霸 到店 `1100` / 外送 `901100`；麦香鸡 `1450` / `901450`），且不同门店在售商品可能不同。**严禁跨渠道、跨门店复用编码或价格**；每次先 `query-meals` 再算价。
8. **特调（`modification`）按 key 规则传参**：选中项用 `selectedKey`；未选中但该组有 `unselectedKey` 的项**也必须一并传入**（用 `unselectedKey`）。`calculate-price` **不回显特调结果**，只能确认不报错，不得据此向用户断言"已生效"。