SkillFoxx

mcd-deal-hunter skill

Skill that works out which coupons apply to a McDonald's China order, the final cost and whether pickup or delivery is cheaper

  • 121 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • Uses a McDonald's China MCP token to read coupons, menus and price calculations.
All reasons and checks

tucookie/mcd-deal-hunterAuthor:TUcookie

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mcd-deal-hunter

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Uses a McDonald's China MCP token to read coupons, menus and price calculations.

This is third-party code. Review the repository files before installing.

What it does

mcd-deal-hunter answers four questions: which coupons apply to this order at this restaurant, how much the order saves, whether delivery or pickup is cheaper, and whether adding an item for a discount is worthwhile. The skill works through McDonald's China MCP and targets clients that support skills, for example DeepSeek Harness. The starting point of the project: for the same burger with fries, pickup cost 36.50 yuan and delivery 48.40. The 11.90 yuan gap is 4.00 from delivery items being priced higher (proportional to the total, so topping up does not dilute it) and 7.90 for delivery plus packaging (a fixed sum that spreads over a large order). So topping up narrows the prices but never equalizes them. The skill shows the difference by component.

Who it is for. People who often order from McDonald's China and want to know which coupon works and whether pickup or delivery is cheaper.

Good fit when

  • Before ordering you must see which of your coupons suit this specific restaurant.
  • Pickup and delivery are compared with a breakdown of markup and fees.
  • You want to estimate whether topping up an item for a discount pays off.
  • A detailed savings calculation for the order is needed before paying.

Not a fit when

  • You are outside China: coupons and menu are tied to McDonald's China MCP.
  • You need dishes chosen by calories: the skill solves a different task.
  • You have no MCP token and cannot get one.

Example request

I want a spicy chicken burger with fries: which coupons fit and what is cheaper, pickup or delivery?

Limitations

A McDonald's China MCP token from open.mcd.cn (phone registration) is required. The token goes into the DeepSeek Harness profile as an `mcd` server with `url` `https://mcp.mcd.cn` and an `Authorization: Bearer` header, after which `mcp__mcd__*` tools appear. The skill folder goes into `~/.dsh/skills/mcd-deal-hunter/`. The skill computes and advises while the user decides and pays. The calculation depends on the MCP response for coupons and the specific restaurant's menu at request time. The repository does not state a license and the description is in Chinese.

How to disable. Delete the `~/.dsh/skills/mcd-deal-hunter/` folder and the `mcp-mcd` block with the token from the profile patch. Revoke the token at open.mcd.cn.

FAQ

How do I connect it?

Configure the `mcd` MCP server with a token in the DSH profile, then place the repository in `~/.dsh/skills/mcd-deal-hunter/`. The skill loads in the next conversation.

Does the client need a restart?

No. Profile changes apply on their own and edits to `SKILL.md` hot-reload.

Why is delivery pricier than pickup?

Part of the gap is higher item prices (proportional to the order) and part is a fixed delivery and packaging fee. Topping up shrinks only the second part.

What questions does it answer?

Which coupons fit, how much the order saves, what is cheaper and whether topping up is worthwhile.

Does the skill create the order?

No. It computes and explains, and the user decides and pays.

Discussion

No questions or reviews yet.

Skills

Skill that prices a group McDonald's China order over MCP, compares service tiers and shows the gap to the next discount.

SkillBroad access110

Skill and CLI that name the cheapest way to order food at McDonald's China and show the outcome before an order is created

SkillBroad access134

Skill and CLI that compare the price of the same McDonald's China order: separately, combos, coupons, via official pricing.

SkillExtended access95

An agent skill that goes through McDonald's China menus and coupons and picks the lowest-priced order

SkillBroad access1.3K

A skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.

SkillBroad access118

McButler works out calories and the full cost of an order, including travel and queue time, from the McDonald's China MCP

SkillExtended access208

README in short

The project explains what makes up the gap between pickup and delivery and uses that as the basis of the calculation. Configuration for DeepSeek Harness is shown in the README.

README badge

Original SKILL.md

---
name: mcd-deal-hunter
description: 麦当劳中国 MCP 的「券 × 商品」到手价优化器。给定想吃的餐品或想用的券，用 calculate-price 做带券/不带券的对照实验，算出真实净省金额与热量代价，输出三栏建议（纯省钱 / 性价比 / 劝退）。Use when 用户问「有什么券能用」「怎么点最便宜」「帮我用券」「这单能省多少」，或在麦当劳下单前想确认优惠是否划算。只做建议，绝不下单或付款。
---

# 券的价值换算

核心洞察：**券本身不含价格。**

`query-store-coupons` 只给 `couponId`、`couponCode`、有效期 `tradeDateTime` 和适用商品 `products[].productCode` —— **没有折扣金额**。`title` 是活动名（实测值为「1024"码"力翻倍」），既不是商品名也不是价格。

因此「省多少钱」只有一个可靠来源：`calculate-price` 带券与不带券的**差值**。禁止用券标题、常识或历史价格推断金额。

## 数据源职责

| 工具 | 给什么 | 陷阱 |
|---|---|---|
| `auto-bind-coupons` | 一键领光麦麦省全部可领券 | 零成本写操作，先领再谈；不要循环调用 |
| `available-coupons` | 可领取券的标题 / 状态 / 图片 | **无 `couponId`**，不能直接用于下单 |
| `query-my-coupons` | 卡包里的全部券 | **不承诺本店本单可用**，不可作为选券依据 |
| `query-store-coupons` | 本店 + 本取餐方式的可用券，含 `couponId` / `couponCode` / 有效期 / `products[]` | 无金额，必须过 `calculate-price` |
| `calculate-price` | 唯一的价格真相 | 金额单位是**分**；对不可售/虚拟 `productCode` 会**静默返回 `price=0` 且 `success:true`**；每次调用计入 600 次/分钟限额 |

选券只认 `query-store-coupons`。用它之外的券去跑价格，会在 `calculate-price` 处失败。

## 流程

1. **定渠道**（决定 `orderType` / `beCode`，详见 `references/ordering.md`）
2. **拿门店**：自取 / 得来速用 `query-nearby-stores`；外送 / 团餐走 `delivery-query-addresses` → `delivery-query-stores`。收藏门店为空会返回 `600050`，改用 `searchType=2` 并索取城市 + 关键词。
3. **领券**：`auto-bind-coupons`
4. **取可用券**：`query-store-coupons(storeCode, orderType, beType)`
5. **取菜单**：`query-meals(storeCode, orderType, beType[, beCode])`，用 `productCode` 对齐
6. **匹配**：券的 `products[].productCode` ↔ 菜单商品 ↔ 用户想吃的。注意券经常把商品锁成一个**套餐**——此时要么引导用户改买，要么直接说这张券用不上
7. **对照实验**：同一购物车跑两次 `calculate-price`，基线（不带券）与带券，差值即净省
8. **输出**，然后停下等用户确认

## 输出（面向用户）

只回答三件事：这单多少钱、怎么更省、代价是什么。**第一句就给实付价**，不铺垫。

```
1. 纯省钱   <方案>   省 X 元    Y kcal
2. 性价比   <方案>   省 X 元    Z 元/100kcal
3. 劝退     <方案>   省 X 元    但 +N kcal ≈ M 碗米饭
```

第三栏是本 skill 的重点：**免费券只免钱，不免热量**。

### 不许出现在回答里

Report a problem