Repolode
Submit
Ayzzz123

Ayzzz123/mcd-coupon-strategist

A McDonald's China MCP-based Skill that calculates the cheapest way to order at your store and flags coupons about to expire.

View on GitHubWebsite
Stars
576
Forks
20
Open issues
0
Last commit
6 days ago

What is it?

mcd-coupon-strategist is a Python ordering-cost assistant built on the McDonald's China MCP server. For a single order, it pulls the current store's menu and the coupons available at that store, enumerates combinations of single items, meal sets, coupon stacks and add-on items, and prices each candidate through the MCP calculate-price tool. It then recommends the cheapest option and warns when adding items to reach a coupon threshold ends up costing more.

For longer-term spending, it reads past orders and the account's coupon list to report the value of coupons nearing expiry, average spend per order, and time-of-day spending patterns. It also checks points balances and expiry dates, and lists campaign dates alongside coupon validity. Coupon values are measured by calculate-price when a coupon code is available, otherwise estimated from menu prices; unknown values are reported as unknown rather than guessed.

The demo runs offline from recorded MCP responses in the fixtures folder and uses only the Python standard library, so it needs no token to try. Running it against the live server requires a McDonald's MCP token.

Key features

  • 01Compares single-item, meal-set and coupon-based orders for the current store.
  • 02Prices each candidate through the MCP calculate-price tool instead of estimating.
  • 03Flags coupon stacking or add-on purchases that end up costing more.
  • 04Reports coupons nearing expiry and their face value from past and current coupon data.
  • 05Summarizes order history by average spend and time of day.
  • 06Runs fully offline in demo mode with recorded responses.

Use cases

  • Choosing the cheapest meal combination within a fixed budget at a McDonald's store.
  • Checking whether it is worth using a coupon or adding items to meet its threshold.
  • Tracking coupons and points that are about to expire on a McDonald's account.
  • Learning how to build an MCP-based ordering workflow with a layered adapter design.

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git
  2. 2

    Enter the project directory

    cd mcd-coupon-strategist
  3. 3

    Run the zero-config demo (no MCP token needed)

    python demo.py

Things to know

  • Live use requires a McDonald's China MCP Token obtained from open.mcd.cn.
  • Savings estimates for coupons without a barcode or menu match may be reported as unknown.

Topics

#mcp#agent#llm#cost-optimization#coupon#python#workflow-automation#mcd-mcp#mcdonalds#skill

FAQ

What is mcd-coupon-strategist?
A McDonald's China MCP-based Skill that calculates the cheapest way to order at your store and flags coupons about to expire. mcd-coupon-strategist is a Python ordering-cost assistant built on the McDonald's China MCP server. For a single order, it pulls the current store's menu and the coupons available at that store, enumerates combinations of single items, meal sets, coupon stacks and add-on items, and prices each candidate through the MCP calculate-price tool. It then recommends the cheapest option and warns when adding items to reach a coupon threshold ends up costing more.
Is mcd-coupon-strategist free to use? What license does it have?
mcd-coupon-strategist is open source under the MIT license. Check the license terms before using it in commercial products.
Is mcd-coupon-strategist still maintained?
Actively maintained. The last commit to mcd-coupon-strategist was on Oct 14, 2026.
What can I use mcd-coupon-strategist for?
Choosing the cheapest meal combination within a fixed budget at a McDonald's store. Checking whether it is worth using a coupon or adding items to meet its threshold. Tracking coupons and points that are about to expire on a McDonald's account. Learning how to build an MCP-based ordering workflow with a layered adapter design.
How do I install mcd-coupon-strategist?
Clone the repository: git clone https://github.com/Ayzzz123/mcd-coupon-strategist.git Enter the project directory: cd mcd-coupon-strategist Run the zero-config demo (no MCP token needed): python demo.py
Where can I get mcd-coupon-strategist?
The source code and installation instructions are on GitHub: https://github.com/Ayzzz123/mcd-coupon-strategist

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects