mcdonald-order

What This Skill Does

The mcdonald-order skill is a specialized OpenClaw agent tool designed to interact seamlessly with the McDonald's China MCP (Model Context Protocol) service. It serves as a comprehensive digital assistant that bridges the gap between the user and McDonald's backend infrastructure. By leveraging this skill, your AI agent can perform a variety of operations including retrieving real-time coupons, browsing campaign calendars, calculating nutritional intake for specific meals, and managing the end-to-end McDonald's delivery process. It acts as a middleware that parses complex API interactions into human-readable information, ensuring that users can optimize their dining experience through voice or text prompts.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Ensure you have the MCD_TOKEN retrieved from the official MCP portal (https://mcp.mcd.cn) ready, as this is mandatory for authentication. Run the following command:

clawhub install openclaw/skills/skills/lililisir/mcdonald-order

After installation, configure your environment variables to point to your specific token and service URL to ensure the agent can execute requests securely.

Use Cases

1. Smart Coupon Management: Automatically fetch, list, and bind available coupons to a user's account without navigating the mobile app.
2. Health-Conscious Dining: Retrieve precise nutritional data (calories, proteins, fats) for menu items, enabling the agent to assist users in selecting meals that fit their daily caloric goals.
3. Event Planning: Provide up-to-the-minute updates on store-wide promotional events and limited-time offer calendars.
4. Delivery Automation: Streamline the delivery process by querying saved addresses and coordinating order creation via the delivery-query-addresses flow, which extracts essential store information (storeCode/beCode) required for successful transaction processing.

Example Prompts

1. "Check if there are any new coupons available for me to claim today and list my current ones."
2. "I want to keep my lunch under 600 calories; which McDonald's items should I order?"
3. "I'm hungry, let's order delivery to my default office address; what's on the menu?"

Tips & Limitations

Always ensure your MCD_TOKEN is kept secure and never hard-coded in shared scripts. The delivery flow depends heavily on the address data retrieved from the server; if no address is associated with the account, the agent will prompt the user to register one first. Note that some promotional campaigns are region-specific; the tool will only return information relevant to the credentials/store codes active in your account context. For optimal results, ensure the environment variable MCD_MCP_URL is set if you are routing through a proxy.