Use when user wants to check McDonald's promotions, claim coupons, or save money on McDonald's orders. Triggers on keywords like coupons, deals, McDonald's, McD, promotions, claim.
A skill that connects to McDonald's China MCP Server to help users discover promotions, claim coupons, and manage their coupon wallet.
This skill uses McDonald's official MCP (Model Context Protocol) service to:
First, check if user has configured a token:
python scripts/token-manager.py list
📝 首次使用需要 MCP Token
获取步骤:
1. 访问 https://open.mcd.cn/mcp
2. 点击右上角「登录」
3. 使用手机号验证登录
4. 点击「控制台」→「激活」
5. 复制生成的 Token
添加 Token:
python scripts/token-manager.py add <名称> <token>
示例:
python scripts/token-manager.py add personal 1kxNLFYT...
Users can manage multiple tokens with custom nicknames:
# Add tokens - nickname can be anything user wants
python scripts/token-manager.py add 我自己 <token1>
python scripts/token-manager.py add 老妈 <token2>
python scripts/token-manager.py add 女朋友 <token3>
# 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.
| 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 |
# 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>
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"}}'
{
"result": {
"content": [{"type": "text", "text": "...coupon data..."}]
}
}
Extract text: result.content[0].text
User: "有什么麦当劳优惠？"
available-couponsUser: "帮我领券" / "一键领取"
auto-bind-couponsUser: "切换到我妈的账号领券"
python scripts/token-manager.py switch 老妈auto-bind-couponsUser: "帮我把女朋友的麦当劳加进来"
python scripts/token-manager.py add <用户起的名字> <token>When presenting coupon info:
| 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 <name> |