SkillFoxx

McMeal Compass skill

A skill and CLI for the McDonald's China menu: three meal options for a budget, with nutrition and a source for every figure

  • 121 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • Online mode sends requests to the official McDonald's MCP with your token; the skill creates no orders
All reasons and checks

smallchristy123/mcmeal-compassAuthor:smallchristy123

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mcmeal-compass

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

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • Online mode sends requests to the official McDonald's MCP with your token; the skill creates no orders

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

What it does

McMeal Compass answers what to order at McDonald's China for a given sum. The skill builds three options: budget first, protein first or balanced. Every figure for calories, protein and price carries a source and a trust level: official record, sum over a combo's parts, partly known or unverifiable. You can set a protein floor, a calorie target, no sugary drinks, or swap a drink or side inside a combo, and nutrition and price are recomputed. It works offline from a menu snapshot in the repository, with no token and no live prices. Online it uses the official `mcp.mcd.cn` MCP to fetch a store's menu and the official price calculation. The skill does not place orders: the feature is switched off in the code and not claimed. The interface and documentation are in Chinese.

Who it is for. People reading the McDonald's menu in China and counting calories, protein and price: travellers, amateur nutrition trackers and developers of clients for the official MCP.

Good fit when

  • The budget is 35 yuan, protein matters and sugary drinks are off the table
  • Two combos look alike and you want to compare them on protein and calories with the source marked
  • A combo's drink is swapped for a sugar-free one and you want the new price and nutrition
  • A developer studies how a client of the official McDonald's MCP prices an order and checks it

Not a fit when

  • You want an order placed: ordering is off and the skill only suggests
  • You need an allergen guarantee or a therapeutic diet: the skill states it cannot guarantee safety
  • You need other fast-food chains or Russian restaurants: only McDonald's China is supported

Example request

I have 35 yuan, want protein and no sugary drinks: show three options in McMeal Compass, offline mode.

Limitations

Data and interface are in Chinese, and so is the project description. Online mode needs a personal `MCD_MCP_TOKEN` from the McDonald's open platform and suits a pre-selected store in China. The author notes that real prices were verified for a single store and time slot, so amounts without official verification are marked unverified. Calorie and protein estimates are not medical advice and do not guarantee allergen safety. The skill was built for a developer contest and calls itself an independent project, and the last commit is from October 2026.

How to disable. Delete the skill folder and the local clone. The token lives in the MCD_MCP_TOKEN environment variable, so remove it from your shell profile.

FAQ

Do I need a token for the demo?

No. After `npm install`, `npm run demo` runs offline over a menu snapshot in the repository. A token is needed only for online mode and live prices.

How do I get a token?

Sign in by phone number on the McDonald's open platform (open.mcd.cn/mcp), request your own MCP token and pass it to the skill in the `MCD_MCP_TOKEN` variable.

What do levels A, B, C and D mean?

A is an official single item with no inference, B a sum over a combo's parts, C partly known data with no full total, and D unverifiable data, where the skill prints no nutrition figures.

How do I swap a drink in a combo?

Pass the `--swap` flag, for example `--swap "选择套餐内饮料=无糖可口可乐中杯"`. The skill accepts only options from the allowed list, asks for clarification when a name is ambiguous, and recomputes nutrition and price.

Can the skill place an order?

No. Order creation is not wired in and is disabled in code with `REAL_ORDERING_ENABLED = false`. The author makes no claim of purchase capability.

Discussion

No questions or reviews yet.

Skills

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

SkillExtended access208

A skill calculates daily calorie targets and builds three ready McDonald's China meal sets from the menu, with sodium warnings.

SkillBroad access104

CLI and skill for McDonald's China orders: pick a meal by calories, price it with coupons and hold the order until confirmed.

CLIBroad access129

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

SkillExtended access95

Skill for McDonald's China orders: enumerates combos under budget and calorie caps and returns three plans

SkillExtended access124

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

README in short

The README is in Chinese. It opens with a short description, what can be checked without a token and a note that real ordering is disabled. It then shows the demo run, CLI flags, trust levels A to D, four states of a price source and the caveats: no medical advice and no allergen guarantee. MCP protocol compatibility and privacy get their own sections.

README badge

Original SKILL.md

---
name: mcmeal-compass
description: 麦当劳菜单营养决策助手（离线可演示 / 在线可核实）。当用户想知道「某家麦当劳门店某预算下吃什么更合适」「这份套餐多少热量/蛋白」「官方实付多少钱」时使用；给出三种视角方案（预算优先 / 蛋白质优先 / 均衡优先），并对每项营养与价格如实标注来源与可信度。不代替下单。
---

# McMeal Compass · 菜单营养决策助手

给一份麦当劳菜单，回答「**在这个预算里，吃哪个更合适**」——并**如实标注每一项证据**：
哪条营养来自官方、哪条只是部分可知、哪条无法验证；价格是**官方实付**还是**未核实的菜单价**。

## 何时使用

Report a problem