Skip to main content
Shipping and tax rate abilities let your AI agent configure the logistics side of your WooCommerce store — creating shipping zones with geographic region restrictions, adding flat rate, free shipping, or local pickup methods to those zones, and managing country- and state-level tax rates. All abilities in this group require an active Pro plan, WooCommerce to be installed and active, and the manage_woocommerce capability on the connected WordPress user.
All WooCommerce shipping and tax abilities require WooCommerce to be active and a Pro plan license. The connected WordPress user must have the manage_woocommerce capability — typically assigned to the Shop Manager or Administrator role.

​
Shipping abilities

​
Tax rate abilities

​
Shipping zone examples

​
maxi/list-shipping-zones

Returns every shipping zone on your site, including each zone’s regions and its configured shipping methods. Each method’s full instance settings — cost, tax status, title, minimum order amount, and so on — are included in the response. Read this first before calling maxi/update-shipping-method so you have the correct zone_id and instance_id values.

​
maxi/create-shipping-zone

Create a new shipping zone. Provide a name and an array of region codes (ISO 3166-1 alpha-2 country codes, or country + state codes like "US:CA" for California).

​
maxi/add-shipping-method

Add a shipping method to an existing zone. WooCommerce supports three built-in method IDs:

​
maxi/update-shipping-method

Update the settings of an existing shipping method instance. The settings object is a partial merge — keys you omit are left unchanged. Call maxi/list-shipping-zones first to confirm the current settings and get the correct instance_id.
Available setting keys vary by method type. flat_rate supports cost, title, and tax_status. free_shipping supports title, min_amount, and requires. local_pickup supports title, cost, and tax_status. Read the current settings via maxi/list-shipping-zones before updating to avoid overwriting unknown fields.
1

Read existing zones and methods

Call maxi/list-shipping-zones with an empty input. Review the returned zones, their region codes, and each method’s instance_id and current settings.
2

Create or update zones

Use maxi/create-shipping-zone to add a new zone, or update regions on an existing zone.
3

Add or update shipping methods

Use maxi/add-shipping-method to attach a method to a zone, or maxi/update-shipping-method to change settings on an existing method instance.

​
Tax rate examples

​
maxi/create-tax-rate

Create a tax rate for a specific country and state. Set compound to true if this rate should be calculated on top of other taxes already applied.

​
maxi/list-tax-rates

List all tax rates on your store, with optional filters. Filter by country to narrow down results for a specific region.

​
maxi/update-tax-rate

Update an existing tax rate. Send only the fields you want to change. Boolean fields such as compound and shipping can be set to false to disable them.

​
maxi/delete-tax-rate

Delete a tax rate permanently by its numeric ID.
maxi/delete-tax-rate removes the tax rate immediately and permanently. Customers checking out after deletion will no longer have that rate applied to their orders.