McD Terminal CLI
A CLI and skill for McDonald's China that finds the cheapest coupon and points payment; the agent orders after your yes.
- 107 ★ on the repository
- Last commit
Broad access
Why this level
- The tool places real orders and spends points after confirmation, and the account token is stored on the machine.
Install
- Works in
Manual install
curl -fsSL --max-time 60 https://gh-proxy.com/https://github.com/Zhangfengmo/mcd-terminal/releases/latest/download/install.sh | bashThe README command for macOS, Linux and WSL (the `gh-proxy.com` proxy is for mainland China and is removed elsewhere). Windows uses `install.ps1`. Then `mcd skill install` and `mcd login`.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The tool places real orders and spends points after confirmation, and the account token is stored on the machine.
This is third-party code. Review the repository files before installing.
What it does
McD Terminal ("麦麦交易终端") runs on top of the official McDonald's China MCP (35 tools). For each item it picks the cheapest way to pay: cash, an existing coupon or points exchanged for a coupon. This is a multiple-choice knapsack problem and the engine solves it exactly. Commands: `mcd order` places an order (`-n` only calculates), `mcd track` and `mcd orders` show orders and pickup codes, `mcd portfolio` and `mcd spend --expiring` work with points and coupons, `mcd party` finds a party slot, `mcd calendar --map` shows a promo map, `mcd stats` counts calories. The skill installs for an agent with `mcd skill install`, and the web version starts with `mcd web`. Before spending points, ordering, a draw or a booking the agent asks, and the person pays by QR code themselves.
Who it is for. Regular McDonald's China customers with piled-up points and coupons who order through an AI agent or a terminal.
Good fit when
- Before ordering you want to compare prices across coupons and points and pick the cheapest option.
- Points are about to expire and need to be spent for the most value.
- A children birthday needs a slot for six people and a booking.
- Calories are tracked from real orders over a week.
Not a fit when
- You are outside China and have no McDonald's China account.
- You want the agent to pay itself: payment always stays with the person.
- You have no token from the open platform `open.mcd.cn/mcp`.
Example request
Order a big burger and a latte, but first show the cheapest payment mix with coupons and points.Limitations
A token from the `open.mcd.cn/mcp` platform is required: phone sign-in, then Console, Activation. The service targets McDonald's China and does not suit other countries. The word "trading" in the name describes payment optimization; there is no exchange trading. The remote MCP has no GPS, so the pickup spot comes from the last or favorite store. The README installer downloads a script from the network through `curl | bash`: read it before running. The repository has no license file. The agent orders and spends points only after confirmation.
How to disable. Run `mcd logout` and delete `~/.local/bin/mcd`, `~/.local/share/mcd-terminal` and `~/.config/mcd-terminal`. Revoke the token on the McDonald's platform.
FAQ
How do I try it without being charged?
`mcd order <items> --dry-run` shows the cheapest payment mix and orders nothing.
Who pays?
The person. After confirmation the terminal shows a QR code that is scanned in the app.
How do I change the pickup store?
Add `--city` and `--near`, for example `--city 成都 --near 天府三街`. The choice is remembered.
What if `mcd` is not found?
Reopen the terminal or run `export PATH="$HOME/.local/bin:$PATH"`.
How do I update?
Rerun the install command from the README.
Discussion
No questions or reviews yet.
Related
CLI toolsA WorkBuddy skill that collects a team McDonald's China order by link and shows how much is missing for the discount.
A skill that reads McDonald's China points through MCP, filters fake mall listings and calculates the points-to-yuan value.
A skill that turns the McDonald's China menu into collectible cards with price and calories; a drawn dish can be ordered via MCP.
A skill on McDonald's China's official MCP that finds nearby chain events and draws a cartoon map of verified sessions only
Binggo MCP дает агенту управлять локальным помощником по розыгрышам Bilibili: вход по QR, список акций, автоучастие.
CDEK MCP and CLI: orders and tracking
mcp-server-cdek
An MCP server, CLI tool and Pydantic models for the CDEK v2 API: creating orders, barcodes, labels, waybills, pickup point search and a local goods catalog
README in short
The README explains installing the terminal and skill, lists features and commands, shows examples, answers common questions and closes with the optimization principle.