Shipping Rates
Configure shipping rates by zone, weight, and method with support for calculated rates and free shipping thresholds.
Shipping Rates define what customers pay for delivery within each shipping zone. Flat rates, weight-based pricing, free shipping over a threshold — all configured here and applied automatically at checkout.
What This MCP Tool Does
This tool lets you create shipping rate configurations, list existing rates, and check which rates are available for a given order context. Rates are attached to shipping zones and can vary by weight, method, and price threshold.
Endpoint Reference
Create a shipping rate:
POST /stores/shipping-rates
Define a new rate with amount, method, zone association, and conditions.
List all shipping rates:
GET /stores/shipping-rates
Retrieve all configured rates across zones.
Get available rates:
GET /stores/shipping-rates/available
Check which rates apply to a specific order context (zone, weight, order total).
Authentication
Requires a Private Integration Token (PIT) with the stores scope enabled.
Key Parameters
When creating rates:
- Zone association (which Shipping Zone this rate applies to)
- Rate amount (flat or calculated)
- Method name (e.g., “Standard”, “Express”, “Overnight”)
- Weight-based conditions (if applicable)
- Free shipping threshold (order total above which shipping becomes free)
Important Notes
Rates require zones to exist first. Create your zone structure through Shipping Zones, then attach rates to each zone.
The “available rates” endpoint is useful for building custom checkout experiences where you need to display shipping options dynamically based on the customer’s location and cart contents.
Free shipping thresholds are a proven conversion tactic. Configure them through rate conditions rather than hardcoding in the checkout flow.
Common Questions
Can I offer free shipping for orders over a certain amount? Yes. Configure a rate with a free shipping threshold. When the order total exceeds the threshold, the rate drops to zero automatically.
How do weight-based rates work? Rates can include weight ranges. The system matches the total order weight to the appropriate rate tier within the zone.
Can I have multiple rate options in the same zone? Yes. A single zone can have Standard, Express, and Overnight options at different price points. Customers choose at checkout.
Related MCP Tools
- Shipping Zones — Zones must exist before rates can be attached
- Carrier Manager — Carrier integrations can provide calculated rates
- Order Manager — Orders capture the selected shipping rate
- Store Settings — Store-level shipping configuration