mcd-what-to-eat: First-Use Guide to the McDonald's Fortune-Draw Meal Skill

This is a WorkBuddy Skill built on McDonald's China official MCP: it turns "what should I eat today" into a ritual-like draw — first shake for today's fortune, then use official real-time store, price, and nutrition data to randomly compose a complete McDonald's meal. The entire process only invokes read-only tools; it will not place orders or join lotteries for you.

Who It's For

• Users who want to trigger a light-hearted meal inspiration in WorkBuddy via natural language (say "what should I eat today" or type /mcd-what-to-eat).
• People who want results based on McDonald's China official real-time data (stores, meals, nutrition info) rather than model hallucinations.
• Not suitable if: you want it to place orders, pay, or join lotteries directly — this Skill explicitly does not invoke write-operation tools like create-order or draw-lottery; it only makes recommendations and displays results. Prerequisites: you need an environment with WorkBuddy installed, and be able to register with the McDonald's open platform using a mobile phone number.

Complete Your First Try in 3 Minutes

1. Get a Token (required): Go to https://open.mcd.cn/mcp → log in with your phone number → "Console" in the top-right corner → "Activate" → copy the Token. The Token is only passed via the environment variable MCD_MCP_TOKEN.
2. Configure the MCP connection: Following the example in the repository's mcp-config.example.json, configure the server as:

{
  "type": "streamablehttp",
  "url": "https://mcp.mcd.cn",
  "headers": { "Authorization": "Bearer ${MCD_MCP_TOKEN}" }
}

1. Install the Skill: In the cloned repository directory, run:

cp -r skill ~/.workbuddy/skills/mcd-what-to-eat

1. Trigger once: Say "what should I eat today" to WorkBuddy, or type /mcd-what-to-eat.

Success signal: You'll see a today's fortune shake, followed by a randomly composed McDonald's meal that references official real-time store and nutrition data (the Skill invokes 4 read-only tools at runtime: query-nearby-stores, query-meals, list-nutrition-foods, and now-time-info).

The first attempt is entirely read-only and produces no orders or charges. The repository states it contains no real credentials, and the generated HTML is also verified to be Token-free.

Use Cases

Case 1: Lunch decision ritual. Scenario: you don't know what to have for lunch. How to invoke: after installing the Skill, say "what should I eat today" to WorkBuddy. Expected result: first a today's fortune shake, then a meal randomly composed based on nearby stores (query-nearby-stores) and currently available meals (query-meals), with nutrition info attached (list-nutrition-foods). The evidence clearly supports up to this point; the exact presentation style is not listed in the official documentation, so refer to the actual output.

Case 2: Check nutrition before deciding. Scenario: you want to stay healthy. After triggering the same Skill, it invokes list-nutrition-foods and now-time-info, using official nutrition data and current time information in its pairing recommendations. Expected result: meal suggestions come with official nutrition data sources; if there are no available stores near your location, the result will reflect the actual query — the specific message for this branch is not documented officially and cannot be known in advance.

Usage Boundaries

• Read/write nature: The Skill only invokes 4 read-only MCP tools (query-nearby-stores, query-meals, list-nutrition-foods, now-time-info) and explicitly does not invoke write operations like create-order or draw-lottery. Read-only does not mean zero risk — it makes network requests to McDonald's official services and authenticates with your Token.
• Credential requirements: You must obtain the McDonald's MCP Token yourself and configure it as the MCD_MCP_TOKEN environment variable; the repository contains no real credentials. Do not leak the Token in public places.
• Local writes: Installation copies the skill directory to ~/.workbuddy/skills/mcd-what-to-eat, which is a local file write; the generated HTML is verified to be Token-free according to the repository.
• Side effects: No remote write operations such as ordering, payment, or lottery; if you need to actually order, please do so separately through McDonald's official channels.
• Unconfirmed information: The Token's validity period and quota limits, compatibility with clients other than WorkBuddy, and the specific display form of the fortune shake results are not mentioned in the official documentation and cannot be confirmed.