McDonald's Coupon Assistant
A skill that connects to McDonald's China MCP Server to help users discover promotions, claim coupons, and manage their coupon wallet.
Overview
This skill uses McDonald's official MCP (Model Context Protocol) service to:
Query available coupons (麦麦省)
One-click claim all coupons
Check campaign calendar
View user's coupon wallet
Token Management
Check if Token Exists
First, check if user has configured a token:
python scripts/token-manager.py list
No Token? Guide User to Get One
📝 首次使用需要 MCP Token
获取步骤:
1. 访问 https://open.mcd.cn/mcp
2. 点击右上角「登录」
3. 使用手机号验证登录
4. 点击「控制台」→「激活」
5. 复制生成的 Token
添加 Token:
python scripts/token-manager.py add <名称>
Add tokens - nickname can be anything user wants
python scripts/token-manager.py add 我自己 < token 1
python scripts/token-manager.py add 老妈 < token 2
python scripts/token-manager.py add 女朋友 < token 3
List all tokens
python scripts/token-manager.py list
Output:
🎫 已保存的 Token:
----------------------------------------
我自己: 1kxNLFYT...LuqJ ← 当前
老妈: 2abCDEFG...XyZ
女朋友: 3mnOPQRS...123
----------------------------------------
Switch active token
python scripts/token-manager.py switch 老妈
Remove a token
python scripts/token-manager.py remove 女朋友 Storage: ~/.mcd-tokens.json (auto-created, permissions 600) Token is cached persistently - user only needs to add once, then it's always available. Quick Reference Action MCP Tool Description List available coupons available-coupons Shows claimable 麦麦省 coupons Claim all coupons auto-bind-coupons One-click claim everything View my coupons my-coupons User's claimed coupon wallet Check promotions campaign-calender Current and upcoming campaigns Get current time now-time-info Server time for validity check Implementation Using Helper Script (Recommended)
Uses token from token manager automatically
python scripts/mcd-mcp.py available-coupons
Or specify token directly
python scripts/mcd-mcp.py available-coupons < token
Direct HTTP Call curl -X POST https://mcp.mcd.cn/mcp-servers/mcd-mcp \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN " \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"available-coupons"}}' Response Parsing { "result" : { "content" : [ { "type" : "text" , "text" : "...coupon data..." } ] } } Extract text: result.content[0].text Example Workflows User: "有什么麦当劳优惠？" Check token exists → if not, guide user to add Call available-coupons Present coupons with prices Offer to claim all User: "帮我领券" / "一键领取" Call auto-bind-coupons Report success count Remind expiry dates User: "切换到我妈的账号领券" Run python scripts/token-manager.py switch 老妈 Then call auto-bind-coupons Confirm: "已用「老妈」的账号领取了 X 张券" User: "帮我把女朋友的麦当劳加进来" Guide to get token from https://open.mcd.cn/mcp Ask user for nickname: "你想给这个账号起什么名字？" Run python scripts/token-manager.py add <用户起的名字>
Confirm addition Response Style When presenting coupon info: Use emojis for food (🍔🍟🍗) Highlight prices and savings Group by category Note expiration dates Show which account is active (if multiple) Common Issues Issue Solution 401 Unauthorized Token invalid/expired, get new one 429 Too Many Requests Rate limit (600/min), wait and retry No token configured Guide user through token-manager.py add Wrong account Use token-manager.py switch Rate Limits 600 requests per minute per token Each token is independent (can use multiple accounts in parallel)