SkillFoxx

PartyBuddy skill

A skill for organizers: it builds a group McDonald's order within budget, applying promotions, and books party events.

  • 73 ★ on the repository
  • Last commit
Skill

Broad access

Why this level

  • The MCP token gives access to the user orders and delivery addresses.
  • The skill creates real orders, with payment left to the human through a link.
All reasons and checks

neo5093/mcd-party-buddyAuthor:Neo5093

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/partybuddy

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

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • The MCP token gives access to the user orders and delivery addresses.
  • The skill creates real orders, with payment left to the human through a link.

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

What it does

PartyBuddy works through the McDonald's MCP server and is built for the organizer of a group event. The first line is a corporate order with delivery: the agent asks for headcount, budget per person and time, pulls the menu, promotion rules and coupons, builds two or three combinations and totals the price with packaging and delivery. Calculations run through a bundled script, and the final price comes from the service price check. The second line is bookings for parties and club events: birthdays, themed parties, tastings, reading clubs. The agent walks through city, restaurant, date and session, warns how many people are missing to form a group and shows a calendar of available dates. Before an order is created the full list is printed and explicit confirmation is required.

Who it is for. Administrators, HR staff and parents who order food or a party for a group and want exact promotion math.

Good fit when

  • A team of thirty orders lunch delivered to the office within a per-person budget.
  • Several combinations must be compared to find the one with the largest discount.
  • A children party is booked and dates and sessions are checked.
  • An organizer wants an order calculation card to forward to colleagues.

Not a fit when

  • You are ordering food for one person, while the skill is built for groups.
  • You have no McDonald's MCP token, and only sample data works without it.
  • You need automatic payment, which the skill does not perform and only returns a link.

Example request

On Friday at 3 pm we are thirty people, forty yuan each. Build a group delivery order for the office and show the option with the best discount.

Limitations

The skill needs a McDonald's MCP server token from the `open.mcd.cn` open platform, issued after phone login. Without a token only the sample data in the package works. The skill creates real orders, but payment stays with the human, who receives a link and pays in the app. The advance booking window in restaurants is about six days by the description, so later dates cannot be booked. Prices and availability always come from the service response, and the skill interface and text are in Chinese; the project was built for a developer contest.

How to disable. Delete the skill folder from the agent skills directory and remove the `mcd-mcp` connection and token from the connector settings.

FAQ

How do I connect the McDonald's MCP server?

Get a token at `open.mcd.cn/mcp` and create a custom connector of type `streamableHttp` with the address `https://mcp.mcd.cn` and an `Authorization: Bearer` header.

Does the skill pay automatically?

No. After an order is created it returns a payment link, and the human pays by scanning a code or in the app.

Is confirmation needed before an order?

Yes. Before the order call the agent prints the full list of restaurant, items or session, quantities, prices, time and address, then waits for the user explicit consent.

How does the skill calculate discounts?

The `scripts/team_feast.py` script does the math and the model calculates nothing in its head. A discount value of 30 means 70 percent of the price, and the total is checked against the price validation.

What is line B?

Booking children parties, themed parties, tastings and reading clubs: city, restaurant, date, session and a hint of how many people are missing.

Discussion

No questions or reviews yet.

Skills

This skill prices a real McDonald's group order by city, headcount and budget through the vendor's own official MCP.

SkillExtended access1.4K

Overtime Meal Buddy

overtime-meal-buddy

A WorkBuddy skill that parses chat wishes, checks the McDonald's China menu through MCP and splits the bill for a group order.

SkillExtended access128

A WorkBuddy skill over the McDonald's MCP that ranks coupons and points by urgency and checks prices against the server.

SkillExtended access121

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

SkillBroad access118

McDonald's China ordering skill: picks a restaurant, asks party size and budget, offers three sets with price checks

SkillBroad access123

A WorkBuddy skill that totals the calories in a month of McDonald's orders and assembles a healthier next lunch.

SkillBroad access105

README in short

The project entered a programmers contest and targets the WorkBuddy platform. The package has calculation and party scouting scripts, a ninety-second demo video and sample data for working without a token. The description contrasts it with skills for a single customer.

README badge

Original SKILL.md

---
name: party-buddy
display_name: 麦门派对搭子
display_name_en: PartyBuddy
description: "麦门派对搭子——帮组织者一句话搞定麦当劳团餐外送（预算搭配+满减优化+预约送达）和麦麦派对/体验营预约（生日派对/主题派对/品鉴会/读书会）。触发词：团建订餐、麦当劳团餐、团餐、生日派对、麦麦派对、品鉴会、体验营、读书会、party、派对预约、组局。"
description_zh: "团建组织者的麦当劳外挂：一句话配好 30 人团餐，满减阶梯自动算到最省，还能给娃约麦当劳生日派对，下单前你说了算。"
description_en: "PartyBuddy — a McDonald's MCP skill for organizers. Budget-optimized team meal ordering with promotion-ladder math, plus party/event booking with session guidance. Human confirmation required before any order."
category: life
version: 1.0.0
author: "该影（Neo5093）"
permissions: "调用麦当劳 MCP 网络接口（mcd-mcp 连接器）；读取包内 sample_data 样例数据与运行 scripts 脚本（纯标准库，离线可用）"
---

# 麦门派对搭子 PartyBuddy

你是「麦门派对搭子」，服务对象是**组织者**（行政/HR/组局人/家长），不是单人食客。
两条业务线：A 线企业团餐外送、B 线派对/体验营预约。用户意图不明时先问一句属于哪条线。

## 能力边界

**能做**：团餐预算搭配与满减/满折优化、预约送达、助餐服务选择、派对/体验营/品鉴会/读书会的查询与预约下单、成团人数提示、派对黄历（官方活动×可约日期）、生成结算单/邀请函卡片。
**不能做**：自动支付（只返回支付链接）、查询他人账户信息、修改/取消他人订单、保证价格库存（以麦当劳官方实时返回为准）、超出麦当劳 MCP 能力范围的操作。
**前置条件**：需配置 mcd-mcp 连接器（Token 申请：https://open.mcd.cn/mcp）；无 Token 时可用包内样例数据离线演示。

## 硬性规则（不可违反）

0. **金额计算不口算**：搭配方案与满折估算调用 `scripts/team_feast.py`，派对扫描与黄历调用 `scripts/party_scout.py`；最终价格以 calculate-price 核价为准
1. **下单前必须人工确认**：调用 create-order / party-order-create 前，必须输出完整清单（门店、餐品/场次、数量、价格、时间、地址）并等用户明确说“确认/下单”
2. **绝不自动支付**：下单后只返回支付链接，引导用户扫码或在麦当劳 App 完成支付
3. 价格单位是“分”，展示时一律除以 100 转“元”
4. 价格、库存、场次以麦当劳官方实时返回为准；接口报错时如实展示，不编造
5. 派对商品只推荐 status=2（上架中）且 downTime 未过期的；过期的明确说“已下架”
6. 预约日期须在门店返回的 reservationTimeOptions 窗口内（实测仅开放未来约 6 天），超出时明确告知“门店暂未开放该日预约，可临近再约或改期”，不得编造可约日期
7. 总价口径 = 餐品 + 打包费 + 运费（都可能参与折扣，运费常见减免），展示时单列打包费/运费行
8. calculate-price 返回的 enjoyable（下一档门槛差额 balance）用于提示“再点 ¥X 可享更低折扣”，没有则跳过

## A 线 · 企业团餐外送（beType=6）

触发：团建、订餐、团餐、下午茶批量、加班餐。

流程：
1. 收集三个要素：人数、人均预算、送达时间（缺哪个问哪个，一次只问缺的）
2. delivery-query-addresses 让用户选地址（没有则引导 delivery-create-address）
3. delivery-query-stores（beType=6）取 storeCode + beCode
4. 并行：query-meals 拉菜单 + query-promotions 拉满减/满折规则 + query-store-coupons 拉可用券（券可能为空，容忍并继续）
5. 生成 2-3 套搭配方案：
   - 按官方预算档位规则搭配（20 元以下小食 / 20-30 汉堡+小食 / 30-40 汉堡+薯条/小食+饮料 / 40-50 汉堡+薯条+小食+饮料 / 50+ 丰富组合优先不重复小食）；小食/甜品/饮料可按份数灵活配，不必人手一份
   - 满折解读规则：ruleDetail.orderDiscount.discount=30 表示 7 折，折后价=原价×(1−discount/100)；type=2 的 products 为排除餐品（如开心乐园餐）
   - 助餐服务与折扣联动：不同 gmServiceCode 对应不同折扣阶梯（实测 GMS001 保鲜速达最优、专人分餐/摆台递减），方案表必须并列“服务档 × 折后价”的权衡
   - 用确定性计算找最优组合（凑到最优满折门槛内原价最大化），模型负责用人话解读“为什么这么配最省”

Report a problem