mc-points-steward skill
A skill that reads McDonald's China points through MCP, filters fake mall listings and calculates the points-to-yuan value.
- 129 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The McDonald's MCP token gives access to the account: points, orders and draws, and redemption and draws spend points after confirmation.
- The token is sent in the `Authorization` header and stored in the MCP config.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mc-points-stewardDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The McDonald's MCP token gives access to the account: points, orders and draws, and redemption and draws spend points after confirmation.
- The token is sent in the `Authorization` header and stored in the MCP config.
This is third-party code. Review the repository files before installing.
What it does
The "麦享掌柜" skill connects to the official `mcd-mcp` MCP server of McDonald's China and keeps track of loyalty points. It shows the balance and points expiring this and next month and reconciles the ledger by the formula earned minus spent minus expired minus frozen. For the points mall it merges all categories, drops items that stay listed after the redemption window ended, and pulls the in-store cash top-up from the product detail, which the list lacks. The `rank_products.py` script parses the price from the name and ranks items by points per yuan. The skill also reviews the lottery prize pool and prize history. An order or a draw starts only on a direct command and after a second confirmation. A Python standard-library script does the math, and the agent words the conclusions.
Who it is for. Users of the McDonald's app in China who collect points and want to know what in the points mall is actually redeemable and what it costs.
Good fit when
- You need your balance and how many points expire this month.
- You must choose what to redeem: after the in-store top-up the price per point varies a lot.
- You want to check which mall items still show as active but can no longer be redeemed.
- You want an assessment of the lottery prize pool before spending points.
Not a fit when
- You live outside China: the service is tied to `mcp.mcd.cn` and a McDonald's China account.
- You need a client other than WorkBuddy: install steps are described for that environment.
- You do not want to issue a token: without it live data is unreadable and only the offline demo is available.
Example request
How many points do I have and what can I actually redeem? Which exchange has the best price per point?Limitations
The skill is written for WorkBuddy and the official McDonald's China MCP server, with texts and data in Chinese. Live data needs a token from open.mcd.cn, and the `Authorization` header must carry the `Bearer ` prefix with a space, otherwise the server returns a 403 error. The server limit is 600 requests per minute per token. The order and draw themselves were not executed in the author's tests: the contract comes from the schema and real deductions were not verified. README figures date from 12 October 2026 and change over time. The offline demo `demo.py` runs on saved snapshots without a network.
How to disable. Delete the skill folder from `~/.workbuddy/skills/` and remove the `mcd-mcp` block from the MCP settings. The token can be revoked in the open.mcd.cn console.
FAQ
How can I try the skill without a token?
Clone the repository and run `python skill/scripts/demo.py`: the demo runs offline on saved data from 12 October 2026. There is also an online demo on GitHub Pages.
How do I connect the McDonald's MCP server?
Get a token at open.mcd.cn and add the `mcd-mcp` server of type `streamablehttp` to the MCP config with the address `https://mcp.mcd.cn` and the header `Authorization: Bearer <token>`. Without the `Bearer ` prefix you get a 403 error.
Can the skill spend my points by itself?
No, redemption and draws start only on an explicit command and after a second confirmation. The author did not run these operations in tests.
Why does the points mall show many fake items?
By the author's data 18 of 27 active items stay listed after the redemption window ends and the status field does not change. The skill compares the item end time with the current server time.
What is the hidden top-up?
Points buy only a voucher, and in the restaurant you still pay the amount from the item name. That amount sits in the product detail `extTradePrice` field and is not shown in the list.
Discussion
No questions or reviews yet.
Related
SkillsA skill that turns the McDonald's China menu into collectible cards with price and calories; a drawn dish can be ordered via MCP.
A CLI and skill for McDonald's China that finds the cheapest coupon and points payment; the agent orders after your yes.
A WorkBuddy skill that collects a team McDonald's China order by link and shows how much is missing for the discount.
A skill on McDonald's China's official MCP that finds nearby chain events and draws a cartoon map of verified sessions only
Binggo MCP дает агенту управлять локальным помощником по розыгрышам Bilibili: вход по QR, список акций, автоучастие.
Local MCP server for product search, cart and delivery with Pyaterochka
README in short
The README shows how points mall data misleads: fake active items, a hidden top-up, identical names and an incomplete default list. It continues with a quick start with an offline demo, skill and MCP setup, a feature table and the split of calculations in the script and judgments in the agent.
README badge
Original SKILL.md
--- name: mc-points-steward description: 麦当劳积分资产管家。This skill should be used when the user asks about McDonald's points balance, what points can be redeemed for, which mall item is worth redeeming, the points lottery, or their prize records. 查积分账本、盘点真实可兑商品、 性价比排序、抽奖参谋、兑换下单（全程二次确认）。 version: 0.1.0 agent_created: true disable: false display_name: "麦享掌柜" display_name_en: "McPoints Steward" description_zh: "麦当劳积分资产管家：去伪、算值、参谋、处置" description_en: "McDonald's points asset steward" visibility: "public" --- # 麦享掌柜 你是「麦享掌柜」，替用户打理麦当劳积分资产的账房先生。 **人设三条**： 1. **数字敏感**——每个结论都要有数字支撑，不报模糊的"挺划算"。 2. **判断给足**——把利弊算清楚摆出来，让用户自己拍板。 3. **绝不越权**——涉及扣积分的操作，没有明确指令绝不动手。 语气：干练、克制，像老练的账房。不用感叹号，不卖关子。 ## 何时触发 用户提到以下任一意图时启用：麦当劳积分 / 麦享会积分 / 积分能换什么 / 积分商城 / 哪个划算 / 积分抽奖 / 中奖记录。