SERVICE & TOOLS

McDonald's

McDonald's ordering and store lookup (requires auth)

ecommerce

19 available tools

available-coupons

Query the list of currently available coupons from Maimaisheng for the user. Returns coupon name, image, status, and promotion tags. Use this tool when the user asks what discounts are available or wh…

query-nearby-stores

Description: Query available stores for dine-in pickup, only for dine-in scenario When: - User asks "I want to dine in" - I want to order McDonald's, pickup in store - Show me nearby McDonald's stores…

campaign-calendar

Query McDonald's China marketing activity calendar for the current month, returning ongoing, past, and upcoming activities. Applicable for viewing user's ongoing and upcoming activities they can parti…

now-time-info

Get current time info - returns complete server time information including: timestamp (millisecond), formatted datetime, year/month/day info, timezone and UTC time. Useful when you don't know current …

auto-bind-coupons

Automatically claim all currently available McDonald's coupons from Maimaisheng. No need to specify specific coupons or couponId, the system will automatically claim all coupons the user can claim. Us…

calculate-price

Description: Calculate product price (including discounts), supports dine-in pickup (orderType=1) and delivery (orderType=2) scenarios 【Required】Must determine order type first, required (1: dine-in, …

create-order

Description: Create McDonald's order, supports dine-in (orderType=1) and delivery (orderType=2) scenarios, must determine order type first, required (1: dine-in, 2: delivery) When: - User says "I want…

delivery-create-address

Description: Create user delivery address, requires beType to query available stores after address creation When: - User wants to add a new delivery address - User wants McDelivery but their delivery …

delivery-query-addresses

Description: In delivery scenarios, supports querying user delivery address list for McDelivery (beType=2) and corporate group meals (beType=6) When: - User wants to order McDelivery - User wants McDo…

list-nutrition-foods

Get nutrition data for common McDonald's items including calories, protein, fat, carbohydrates, sodium, calcium and more. Useful when users ask about calories, nutrition, or need help planning meals w…

mall-create-order

Create points redemption order - used when user asks "Redeem points for this product", "Redeem this coupon", user confirms redemption. Note: One order per product; if user needs to redeem multiple pro…

mall-points-products

Query redeemable coupon list - used when user asks "What point redemption products are available", "What can I redeem points for", "View points mall" Preconditions: - User is logged in

mall-product-detail

Query points redemption product details - used when user asks "What's the product details", "View product detailed information", user clicks product to view details Preconditions: - Known product SPU…

query-meal-detail

Description: Meal details, supports dine-in pickup (orderType=1) and delivery (orderType=2) scenarios Input: - storeCode: Store code, required - Dine-in pickup scenario: orderType=1 && beCode=null - D…

query-meals

Description: Meal list, supports pickup (orderType=1) and delivery (orderType=2) scenarios For corporate group order, recommend combinations based on: - **Under 20 yuan**: Sides - **20-30 yuan**: Burg…

query-my-account

Query user points account details - used when user asks "How many points do I have", "Check my points", "Points balance", "Query expired points" Preconditions: - User is logged in

query-my-coupons

Get user's coupon assets in their wallet, used for "What coupons do I have / View coupon details" display and management scenarios. Note: This interface returns coupons owned by the user, does not per…

query-order

Description: Query order details When: - User asks "Check order details", "Order status", "My orders" - User provides McDonald's order number to query delivery progress - User says payment succeeded o…

query-store-coupons

Description: Query coupons available at current store, supports pickup (orderType=1) and delivery (orderType=2) scenarios When: - When user has obtained store and asks "What coupons can I use" - When …