Skip to content

McButler for McDonald's China

by JOUaaaaaSkillGet organised

Compares McDonald's China meals by price, nutrition and store, and plans group orders

View on GitHub

About McButler for McDonald's China

A skill for ordering at McDonald's in mainland China through its MCP server. It suggests meals, totals nutrition for each combo, compares nearby stores by price and queue time, and splits group orders.

For McDonald's customers in ChinaPeople watching caloriesOffice staff ordering for a team

Made by JOUaaaaa

An open-source skill by JOUaaaaa, published on GitHub as an entry in McDonald's China's 1024 Programmers' Day contest.

Stars
★ 217
License
MIT
Cost
Free
Level
Intermediate
Contents
Includes scripts

Examples

From the project's own repository.

The McButler theater page: five cartoon characters argue over an order and end on a final pick with calories, health score and price
Image: JOUaaaaa (MIT). Original file

Overview

McButler is a skill for ordering at McDonald's in mainland China through the chain's MCP server. Tell it where you are and your budget or diet, and it suggests meals, splits a combo into its items to total calories, protein, fat and sodium, compares nearby stores by price plus walking and queue time, and divides a group order by dietary needs. It stops at the confirmed price unless you ask it to order. It is an independent contest entry, not a McDonald's product, and it works in Chinese.

It adds up a whole combo's nutrition from the official per-item data and labels which numbers are measured, official or estimated.

Try these first

Start with the first one: it is a small task you can check easily.

  1. Check the calories, protein, fat and sodium of the [combo name] combo, and label which numbers are estimated.First try · read-only

  2. I'm near [street] in [city]. Which nearby store is cheapest for [combo] once walking and queue time count?

  3. Plan a team lunch for 30 people at 30 yuan each; 5 don't eat beef and 4 don't eat spicy food.

  4. Order the option you just recommended.places a real order

Example prompts written by Agent Flows Hub.

What you get

From the creator's documentation.

OutputWhat it isReads
Meal suggestionsBudget, healthy or popular picks from the current menuMcDonald's China MCP
Combo nutrition checkCalories, protein, fat, sodium and calcium per item, with a score out of 100McDonald's China MCP
Store comparisonNearest, cheapest or lowest total cost including walking and queue timeMcDonald's China MCP
Group ordersSplits a group by diet and budget into an item list ready for pricingMcDonald's China MCP
Account scoreA 300 to 950 score built from your orders, coupons and pointsYour McDonald's account
OrderingPlaces an order only after you clearly ask for itYour McDonald's account

Good to know

Ask about a McDonald's China order in Chinese: which nearby store is cheapest once walking and queue time count, how many calories a combo has, or how to split a team lunch by budget and diet. The skill pulls menu, price and nutrition data through the chain's MCP server.

Limits

  • Setup is documented in Chinese for WorkBuddy and needs a McDonald's China MCP token; it covers mainland China stores only.
  • As the project states, nutrition results are for reference only and are not medical advice. Queue times are your own input or an estimate, because the MCP server does not provide them.

Notes by (original project name: mcd-self-butler), written from the creator's documentation, not from running it ourselves. McButler: features and setup (Chinese) · McButler: MCP tools and call flow (Chinese)

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

Other skills

See all 140 skills · A skill is installed but not loading

GitHub