McDonald's Experience Atlas skill
mcd-experience-atlas
A skill that finds McDonald's party events in China: cities, restaurants, dates, sessions and prices via the official MCP.
- 132 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Queries go to the official McDonald's MCP with your token.
- SKILL.md covers creating an event order; it is off by default and needs an exact confirmation phrase.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcd-experience-atlasDetects 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.
- Queries go to the official McDonald's MCP with your token.
- SKILL.md covers creating an event order; it is off by default and needs an exact confirmation phrase.
This is third-party code. Review the repository files before installing.
What it does
The skill answers where in China a McDonald's children's birthday, themed party, tasting or reading club can be held, in which restaurant, on which date and session, how many places remain and the price. Queries go to the official McDonald's MCP in a chain from the activity catalogue to cities, restaurants, dates and sessions. The skill also knows a 160-item nutrition table and the points-lottery prizes. The repository also ships an interactive map with a snapshot from 13 October 2026: 281 cities, 3664 restaurants, 26 activities. Collected datasets live in `data/`.
Who it is for. Parents and assistants in China planning a McDonald's party who ask an agent where and when it can be held.
Good fit when
- You need to learn in which Chinese cities McDonald's runs children's birthdays.
- For a given restaurant you want to check free dates and weekend sessions.
- You want to compare how many activity types are available in different cities.
- A question about dish calories comes up; the skill reads a 160-item nutrition table.
Not a fit when
- You are outside China; the data and MCP belong to McDonald's China.
- You need fresh data without an MCP token; the ready map shows a snapshot from 13 October 2026.
- You want an event booked without your oversight; booking is disabled and needs an exact confirmation phrase.
Example request
I am in Chengdu. Where can I hold a children's birthday at McDonald's, which restaurants do it and is there a free session this Saturday?Limitations
The data and MCP belong to McDonald's China, and the documentation and interface are Chinese. The official MCP token is issued at `open.mcd.cn/mcp` after phone-number login and is needed only to collect fresh data and to query through an agent. `SKILL.md` describes order creation with a two-step guard: it is off by default and runs only after an exact confirmation phrase and an order fingerprint check. The README meanwhile calls the mode read-only, so verify the behaviour before use. The scripts need Python 3.8 or newer.
How to disable. Remove the skill directory from the agent's skills directory and delete the `mcd-mcp` connection from the MCP config along with the `MCD_MCP_TOKEN` token.
FAQ
Do I need a token to view the map?
No. The map opens from `index.html` or the GitHub Pages address without a token. A token is needed only to collect new data and to query through an agent.
Where do the scripts take the token from?
From the `MCD_MCP_TOKEN` environment variable, or failing that from `~/.workbuddy/mcp.json` when a `mcd-mcp` connector is configured in WorkBuddy. The scripts create no local credential files.
Which MCP tools does the skill use?
The list is in `allowed-tools` of `SKILL.md`, for example `query-party-city`, `query-party-store` and `query-party-store-session`. The agent gets the date from `now-time-info`.
How do I verify the install without a token?
Run tests such as `python tests/test_data_pack.py`. There are 98 checks in total and none needs a token.
What data does the repository contain?
The `data/` directory holds cities, restaurants, activities, sessions, the nutrition table, the lottery and the campaign calendar collected on 13 October 2026.
Discussion
No questions or reviews yet.
Related
SkillsThe "Party Scout" skill uses McDonald's official MCP in China to find restaurants and open dates for a kids' party.
McMates: a McDonald's China ordering skill with memory
mcd-1024-skill
A skill over the McDonald's China MCP: one order pick, memory of your past orders and a Big Mac price index across cities
A skill that finds unusual McDonald's China menu combos from what is on your tray and checks new items via MCP
This skill prices a real McDonald's group order by city, headcount and budget through the vendor's own official MCP.
A skill for ordering from McDonald's China via its official MCP: coupon-aware prices, nutrition, order status and a quiet summary.
Skill for McDonald's China orders: enumerates combos under budget and calorie caps and returns three plans
README in short
The README is written in Chinese and covers the data, the web map, promotion copy templates and the collection procedure. The Python data collector uses only the standard library.
README badge
Original SKILL.md
---
name: mcd-experience-atlas
description: 麦当劳体验活动地图。当用户想查询麦当劳的生日派对、主题派对、亲子读书会、品鉴会、体验营等体验类活动「在哪些城市能办、哪家门店可以、哪天可约、几点有场次、还剩多少位、多少钱、多少人起订」时使用本技能。也可用于查询麦当劳餐品营养（160 项）与积分抽奖奖池。查询与下单均通过麦当劳官方 MCP；下单默认关闭，仅在用户精确说出「确认创建订单」并核对订单指纹后才会执行。
description_en: McDonald's China experience-activity atlas. Use when the user asks where a McDonald's birthday party, themed party, reading club, tasting event or experience camp can be booked, which stores offer it, which dates and sessions are available, how many slots remain, the price and the minimum party size. Also covers McDonald's menu nutrition (160 items) and the points-lottery prize pool. Ordering is disabled by default and only fires after the user says the exact phrase "确认创建订单" and confirms the order fingerprint.
license: MIT
allowed-tools:
- mcp__mcd-mcp__mall-points-products
- mcp__mcd-mcp__mall-product-detail
- mcp__mcd-mcp__query-party-city
- mcp__mcd-mcp__query-party-store
- mcp__mcd-mcp__query-party-store-date
- mcp__mcd-mcp__query-party-store-session
- mcp__mcd-mcp__list-nutrition-foods
- mcp__mcd-mcp__query-lottery-info
- mcp__mcd-mcp__campaign-calendar
- mcp__mcd-mcp__now-time-info
disable: false
---
# 麦当劳体验活动地图
把麦当劳体验活动的可预约性，从「App 里逐级翻五步」变成「一次查询」。
## 何时使用
- 用户问「麦当劳生日派对哪里能办」「成都有没有麦当劳派对」
- 用户问「这家店这周六还有派对场次吗」「多少钱」「几个人起」
- 用户问「麦当劳品鉴会 / 读书会 / 体验营怎么参加」
- 用户问「麦当劳哪个餐品热量最高」（走 `list-nutrition-foods`）
- 用户问「积分抽奖有什么奖品」（走 `query-lottery-info`）
## 数据来源与链路
入口是**积分商城**，不是独立的派对工具：
```
mall-points-products → 取体验类 SPU（shopId=5）
→ mall-product-detail(spuId) → skuId / partyType / 人数与年龄规则 / 提前预订天数
→ query-party-city(spuId) → 该品类可预约城市（281 个）
→ query-party-store(code,lat,lng) → 该城市可办门店
→ query-party-store-date → 可约日期（滚动）
→ query-party-store-session → 场次：时段 / 人数 / 价格 / 余位
→ party-order-create → 下单（写操作，默认关闭，见下）
```