CS

conan9/super-mcd-benefits-radar

Developer tools

This page was translated automatically. Technical details may differ from the original. View the original

31 stars 0 forks Quality 70 Trend 27NOASSERTION

AI-powered McDonald's benefits radar built with MCP and WorkBuddy.

Overview

: Aggregate the ** scattered across McDonald's China MCP tools into a ** "rights check-up report," directly answering the most likely losing point—pure read-only, no fabrication, zero third-party dependencies. Install and use it, running about 4 API calls per run. Within the McDonald's app, 'My Coupons', 'MaiMai Savings', 'Points', and 'Promotions' are scattered everywhere, each with a different expiration date. Real pain points**. 1. : Read-only calls to 4 official MCP tools (My Coupons / Points Account / Available Coupons / Event Calendar); 2. : Use the project's own code to calculate remaining days, sort by hierarchy, and remove deduplication across sources; 3. : Generate an 8-section Markdown report, write whatever is missing. * — Someone needs to prioritize for them; * ; * — This project provides a complete model for "what read-only can achieve." Go to https://open.mcd.cn/mcp → the top right corner of [Login] (Phone Number Verification), → [Console]→ [Activate]→ and copy the token. Left sidebar: [Expert · Skills · Connectors] → [Connectors] → Top right [Custom Connectors] → [Configure MCP], fill in the mcp-config.example.json content (): : Copy this directory to the user-level skills directory; the directory name must remain super-mcd-benefits-radar: * Python (only using standard libraries: json / urllib / datetime / unittest) * No pip installation required for anything

Overview (machine translated)

In a nutshell: Compile all the coupons, points, and promotions scattered across the four MCP tools at McDonald’s China into one dish Priority Health Check Reports Sorted by Urgency Upon Expiry, directly answer the question that is most likely to lose out—

“Which coupons and points are about to expire? How should I use them these days?”

Pure read-only, no fabrication, zero third-party dependencies. Ready to use once installed, running about 4 API calls per run.

Item Value
Chinese Name Super Mai Rights Radar
English Name Super McBenefits Radar
Skill identifier super-mcd-benefits-radar(= repository name / directory name / SKILL.md of name)
Type WorkBuddy Skill (Python standard library, no third-party dependencies)
License MIT

⚠️ > **This project is an independent entry for the ‘McDonald’s Programmers Festival Creative Development Competition’, independently developed by the participants,

Does not represent official McDonald’s products and does not receive McDonald’s brand endorsement. ** Project output is for reference only; Meal information, prices, rules, and supply status are subject to real-time results from McDonald’s official channels.


Understand what it does in 30 seconds

Within the McDonald’s app, ‘My Coupons,’ ‘McSavings,’ ‘Points,’ and ‘Promotions’ are scattered across four locations, each with a different expiration date. The real pain point isn’t “no coupons,” but “too many vouchers with irregular maturity dates, making it hard to tell the difference.”

Chaomai Rights Radar does three things:

  1. Withdrawal: Read-only calls 4 official MCP tools (My Coupons / Points Account / Available Coupons / Event Calendar);
  2. Calculation: Use the project’s own code to calculate remaining days, sort by hierarchy, and remove deduplication across sources;
  3. Delivery: Produce an 8-section Markdown report, pinned in P0/P1, write whatever is missing.

To sum up its design choices in one sentence:

**It doesn’t spend money on users, only records things for users. **


What problems does it solve?

Pain Point Consequences Response to This Project
Too many coupons with irregular expiration dates, can’t tell the weight by looking through the list Coupons left unused and expired Divided into 7 tiers based on remaining days, P0/P1 pinned separately
Existing coupons mixed with “available coupons” Repeated reminders, wasted efforts Cross-data source deduplication, and already held coupons are separately marked
Points “About to Expire” Hidden in Small Print Points Silently Reset Points section listed separately and upgraded to P1
Event deadline not obvious Missed limited-time event Event calendars are positioned by calendar day (Today / Future / Past), and truthfully state “Official does not provide validity period”
Seeing blank spaces, unsure if it’s “not read” or “not read” Making incorrect judgments Parsing failure will trigger an alarm, never disguise “can’t understand” as “no data”

Target Users

This page was translated automatically. Technical details may differ from the original.

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{ "mcpServers": { "mcd-mcp": { "type": "streamablehttp", "url": "https://mcp.mcd.cn", "headers": { "Authorization": "Bearer YOUR_MCP_TOKEN" } } } }