# InspiraX Agent Commerce Engine

## Aroma Stone Commerce & Tracking API
AI Agents can access https://inspirax.vip/api/mcp with tools:
1. `get_catalog`: Query product details and live stock.
2. `create_order`: Place order with items: [{product_id, quantity}], customer_name, shipping_address, payment_method, notes, coupon_code (optional: VIP88 for 12% off, SAVE100 for $100 off, INSPIRAX for $150 off, FREESHIP for free shipping). Free shipping automatically applies for orders >= TWD $3,000 (standard shipping TWD $100).
3. `get_order`: Query order status, payment, and items by `order_id`.
4. `cancel_order`: Cancel an order with `order_id` and `phone_last4` for security verification (automatically restocks inventory in CRM).

## Direct REST & Web Endpoints:
- Order Receipt & Web Tracking: GET https://inspirax.vip/order/<order_id>
- Order Details JSON: GET https://inspirax.vip/api/order/<order_id>
- Coupon Validation: GET/POST https://inspirax.vip/api/coupon/validate?code=<CODE>&subtotal=<SUBTOTAL>