McFairSplit skill
McFairSplit splits the bill for a shared McDonald's China order by what each person ate and shows the line-by-line math
- 259 ★ on the repository
- Last commit
Extended access
Why this level
- The order reading mode uses an account token and receives data about your purchases.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/mcfairsplitDetects 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.
- The order reading mode uses an account token and receives data about your purchases.
This is third-party code. Review the repository files before installing.
What it does
A skill and CLI on the Python 3.10 standard library for fair bill splitting. The agent first assigns order items to people and records the rules everyone agrees on: a drink for one person, a combo burger split by two, nuggets shared. A script then computes what each owes, including discounts and delivery, and prints the working. `python3 scripts/cli.py solve --demo four_people --compare equal --html exports/demo.html` builds an HTML report comparing proportional and equal discount sharing. An optional mode reads orders through the McDonald's China MCP platform with a token.
Who it is for. Groups of friends and colleagues in China where one person pays for a shared order and then everyone argues about who owes what.
Good fit when
- One person paid for an order of five and the bill needs splitting with combos.
- A discount should be shared by rules, showing how it changed the amounts.
- You need a report to send to the participants.
- Reading your own orders through an MCP token must be tried on a demo.
Not a fit when
- The order is not paid in yuan or has more than ten participants.
- You need an official McDonald's product: the project is independent.
- You want to pay from the skill: it only shows amounts.
Example request
Use McFairSplit: show the four-person demo, compare discount sharing by proportion and equally, and export HTML.Limitations
Version 0.1.2 handles one paid order in yuan, two to ten people and at most 30 charge lines, with one person paying everything. The project is independent and not a McDonald's product. Reading orders needs a token from the `open.mcd.cn/mcp` platform, passed through the `MCD_MCP_TOKEN` variable and never in the repository or command arguments. Example data is synthetic. The licence is not identified in metadata (NOASSERTION).
How to disable. Delete the skill folder from the skills directory and `private/orders.json` if you exported orders. Revoke the token on the McDonald's platform.
FAQ
Is a token required for splitting?
No. Splitting works with entered items and the demos. A token is only for reading orders over MCP.
What does it calculate?
Each person's amount with discounts and delivery, with the source of every figure and the difference under another sharing method.
Where are exported orders stored?
In the `private/` directory, which should not be committed. Do not write the token into files.
What does the `mcp` mode do?
`mcp probe`, `mcp orders` and `mcp order --id ...` read your orders in read-only mode and save a snapshot to `private/`.
What limits does the calculation have?
One paid order in yuan, two to ten people and at most 30 charge lines.
Discussion
No questions or reviews yet.
Related
SkillsMcDonald's China ordering skill: picks a restaurant, asks party size and budget, offers three sets with price checks
Skill and CLI that name the cheapest way to order food at McDonald's China and show the outcome before an order is created
Picks a complete McDonald's China order for your budget and taste at official prices and returns a ready order card
An agent skill that goes through McDonald's China menus and coupons and picks the lowest-priced order
A skill on the McDonald's China MCP: turns a budget and wishes into up to three menus with official prices, leftover budget and coupon terms
CLI and skill for McDonald's China orders: pick a meal by calories, price it with coupons and hold the order until confirmed.
README in short
A fair order split by who ate what, with detail and a report, on the Python standard library.