SERVICE & TOOLS
McDonald's
McDonald's ordering and store lookup (requires auth)
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 …