SkillFoxx

McEvent Radar skill

A skill on McDonald's China's official MCP that finds nearby chain events and draws a cartoon map of verified sessions only

  • 90 ★ on the repository
  • Last commit
Skill

Extended access

Why this level

  • Stores the official McDonald's MCP token in agent settings and asks for it in chat
  • Calls a third-party API and may save query results into local files
All reasons and checks

zafer-liu/mcd-event-radarAuthor:Zafer-Liu

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/mcevent-radar

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

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Stores the official McDonald's MCP token in agent settings and asks for it in chat
  • Calls a third-party API and may save query results into local files

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

What it does

The skill answers questions like which McDonald's events are nearby and where to go at the weekend. It takes data only from McDonald's China's official MCP (the `mcd-mcp` connector with 35 tools) in real time. Restaurant coordinates come from the chain's official data. Event cards include only sessions that the service confirmed still have seats. The result is a map of cartoon houses on real coordinates, with filters by date and event type, and an `.ics` calendar export. The skill forbids passing off web search, model memory or `examples/sample-events.json` as an answer: if nothing is found, it says so. On first run it walks the user through getting a token and configures the connector itself. A command-line route exists: `npm run live`, `npm run radar`.

Who it is for. WorkBuddy and other agent users in China looking for kids' parties, reading clubs and tastings at McDonald's restaurants.

Good fit when

  • You want the restaurant nearest home with a birthday party this weekend that still has seats
  • You need an events map for the next 14 days in Beijing with a date filter
  • You want to export matching sessions to a calendar as an `.ics` file
  • You need to check how many seats remain for an event from the official service

Not a fit when

  • You are outside China: the service and events belong to McDonald's China
  • You need food ordering and payment: the skill only searches events
  • You have no McDonald's China MCP token and do not want to get one

Example request

What McDonald's events are nearby in Beijing over the next two weeks? Draw the map

Limitations

  • Working data comes only from McDonald's China's official MCP and needs a personal token obtained by phone-number login in the service console.
  • The token has to be given to the agent in chat, and the authors warn that it equals an account credential: keep it in your own conversation only.
  • The demo map on the author's site shows fictional data, and real data arrives after the token is connected.
  • Texts and instructions are in Chinese, and the skill is built for queries about Chinese cities.

How to disable. Delete the `mcd-event-radar` skill folder from the skills directory (for WorkBuddy it is `~/.workbuddy/skills/`) and remove the `mcd-mcp` connector with its token from the agent settings.

FAQ

How do I install the skill?

Copy the `skill/mcd-event-radar` folder into the agent skills directory. For WorkBuddy you can upload `dist/mcd-event-radar-skill.zip` in the Skills section or run `install.sh`.

Where does the skill get its data?

From McDonald's China's official MCP in real time. The skill must not pass off invented or sample data as a result.

Is a token required?

Yes, for real data. It is obtained in the service console after phone login. Without a token only a demo map on fictional data is available.

What does the result show?

A map with restaurants on real coordinates and session cards with price and seats left, plus an `.ics` calendar for chosen events.

Does it work outside China?

Not for McDonald's in Europe or elsewhere: the data and the connector belong to the chain in China only.

Discussion

No questions or reviews yet.

Skills
Needs a VPN

A skill that reads McDonald's China points through MCP, filters fake mall listings and calculates the points-to-yuan value.

SkillExtended access129

A skill that turns the McDonald's China menu into collectible cards with price and calories; a drawn dish can be ordered via MCP.

SkillBroad access125

A CLI and skill for McDonald's China that finds the cheapest coupon and points payment; the agent orders after your yes.

CLIBroad access107

A WorkBuddy skill that collects a team McDonald's China order by link and shows how much is missing for the discount.

SkillBroad access107

Binggo MCP дает агенту управлять локальным помощником по розыгрышам Bilibili: вход по QR, список акций, автоучастие.

MCP serverBroad access389

A macOS MCP server on AppleScript: the agent drives Calendar, Mail, Messages, Notes, Finder, iTerm and Shortcuts

MCP serverBroad access396

README in short

The README presents the skill as a McDonald's developer contest entry and an events radar. It gives a quick tour, a link to the live demo and video, three installation steps, observations checked with a real token and console commands. Separate files describe the MCP integration and the contest terms.

README badge

Original SKILL.md

---
name: mcd-event-radar
description: 麦麦活动雷达——查「附近有什么麦当劳活动」「周末去哪家麦麦主题活动」「某城市的生日派对/主题派对/体验营/品鉴会/读书会及可预约场次」，并可把结果生成卡通活动地图（门店位置取自官方经纬度）。首次使用自动引导申请官方 Token 并一键配置连接器，支持城市级位置检测；区分「已核实可预约场次」与「活动线索待核实」，用户确认后才创建主题活动订单。
---

# 麦麦活动雷达

回答「附近有什么麦当劳活动」「周末能去哪个麦麦主题活动」「帮我查某城市的派对或品鉴会」等问题。数据全部来自麦当劳中国官方 MCP（`mcd-mcp` 连接器），并配套直连命令行作为兜底。

**红线**：不得用网页搜索、模型记忆、`examples/sample-events.json` 或任何推测数据冒充实时 MCP 结果。查不到就说查不到，并说明已查范围与缺失环节。

## 初次使用 · 小白三步走（未配置时必走）

第 0 步自检发现「未配置」时，按下面流程引导，全程不需要用户编辑任何 JSON：

**第 1 步 · 获取 Token（约 1 分钟）**

把下面这段话**原样**发给用户：

> 打开麦当劳 MCP 开放平台：**https://open.mcd.cn/mcp/doc**
> ① 点右上角【登录】，用手机号验证登录；
> ② 登录后「登录」按钮变成「控制台」，点它；
> ③ 在弹出的控制台弹窗里点【激活】按钮，申请 MCP Token；
> ④ 同意服务协议；
> ⑤ Token 出现后点【一键复制】，直接粘贴到这个对话里发给我。
> ⚠️ Token 等同于账号凭证：只发在这条对话里，不要发到群聊、朋友圈或 GitHub。

**第 2 步 · 自动配置（用户贴出 Token 后立即执行）**

用内置一键脚本写入 WorkBuddy 私有配置（自动备份原文件、保留已有服务器、在线验证 Token）。命令（`<skill目录>` 指本 Skill 的 base directory）：

```bash
MCD_MCP_TOKEN='<用户贴的Token>' node "<skill目录>/scripts/setup-connector.mjs"
```

PowerShell 环境改用：`$env:MCD_MCP_TOKEN='<Token>'; node "<skill目录>/scripts/setup-connector.mjs"; Remove-Item Env:\MCD_MCP_TOKEN`

- 脚本输出含在线验证结果（服务名、工具数、核实链是否齐全）与「还差两步」提示，把结论转述给用户。
- **Token 安全**：只允许通过该脚本写入用户本机的 `~/.workbuddy/mcp.json`；不得在回复、示例、记忆文件、日志或仓库文件中回显或保存 Token。
- 若验证提示 Token 无效（401）：请用户回平台重新申请，再跑一次脚本覆盖即可。

**第 3 步 · 激活（WorkBuddy 平台要求，约 30 秒，无法跳过）**

① 连接器管理页 → 自定义连接器 → 对 `mcd-mcp` 点「Trust」；
② 聊天窗口左下角「+」菜单 → 启用 mcd-mcp；

Report a problem