WowShipping MCP lets you retrieve shipping information, validate rules, simulate checkout rates and manage supported shipping rules and settings in your WooCommerce store using AI assistants.
Available operations depend on your installed WowShipping version, active license, account permissions, MCP access mode and OAuth consent scopes where applicable.
Supported Capabilities and Example Prompts
| Capability | What You Can Do | Example Prompt |
|---|---|---|
| Store overview | Retrieve currency, units, access mode and capabilities. | Show my shipping store overview. Do not change anything. |
| Rules and zones | Find shipping rules and zones and inspect rule configurations. | List my shipping zones and draft rules with their IDs. |
| Rule options and catalog | Retrieve supported methods, conditions, products, variations, categories and shipping classes. | Show supported shipping conditions and find my shipping classes. |
| Validation | Validate a rule without saving it. | Validate this proposed shipping rule and explain any errors. |
| Checkout simulation | Preview rates for a saved rule or unsaved draft. | Ask for the required inputs and simulate this shipping scenario. |
| Rule management | Create drafts, update, publish, disable and delete rules when authorized. | Prepare an unpublished shipping rule and show it for review. |
| Settings | Retrieve or update supported shipping tax and debug settings. | Show my shipping tax and debug settings without changing them. |
Validate Shipping Rules Without Saving
The validate-rule tool checks a proposed shipping rule without saving changes. It is available with Read only access.
Retrieve get-rule-options first to identify supported fields, operators and value formats.
Rule Validation Requirements
- Include a scenario name, a valid zone ID and exactly one shipping method.
- Use zone
-1for global rules or zone0for Rest of the world. - Flat shipping uses one fixed rate without tier conditions.
- Free shipping uses one zero-cost fixed rate with a condition. General/always is supported.
- Flexible shipping supports tier conditions.
- Use decimal strings for costs.
- For the between operator, provide both endpoints in order.
- Incremental rates require a positive
everyValueand an exact supportedCart:basis. - Enabled display rules must contain nonempty condition groups.
Example prompt:
Use WowShipping to retrieve supported rule options, prepare a configuration for my requirements and validate it without saving. Explain any validation errors.
Simulate Checkout Shipping Rates
The simulate-checkout tool previews shipping rates for a saved rule or an unsaved draft using Read only access.
Provide exactly one of ruleId or draftRule, along with cart items and a shippingAddress.
| Input | Requirement |
|---|---|
| Cart items | 1–50 distinct cart lines. |
| Product ID | A published productId for each cart line. |
| Quantity | An integer from 1 to 1,000 per line. |
| Product variation | The parent productId and a matching published variationId. |
| Shipping address | Two-letter country code, plus state, city and postcode where WooCommerce requires them. |
Checkout Simulation Limitations
- Simulation uses a guest cart and does not save a cart or session.
- Other shipping rates may appear in the results.
- Live WowShipping carrier quotes cannot be simulated, even with Pro.
- Guest simulations do not verify customer-specific or logged-in shipping behavior.
Example prompt:
Simulate a saved WowShipping rule using a test cart and delivery address. Ask for the rule ID, products, quantities and required address fields. Do not save or publish changes.
Create, Review and Publish Shipping Rules
With Manage or Full access, you can create unpublished rules, update drafts, publish reviewed rules and disable existing rules.
Follow this workflow:
- Retrieve supported rule options.
- Prepare the proposed rule configuration.
- Validate the configuration.
- Create an unpublished rule.
- Simulate representative checkout scenarios.
- Review the results and approve publication.
Publishing is a separate operation from creating a shipping rule.
Example prompt:
Prepare an unpublished shipping rule based on my requirements. Ask for missing details, validate the configuration and show it for review. Do not publish it.
Edit a Published Shipping Rule
Published rules must be returned to draft before they can be updated.
- Identify the rule and approve the proposed changes.
- Call
disable-ruleto return it to draft. - Retrieve the rule’s latest revision.
- Update the draft using its
id,expectedRevision, a uniquerequestIdand the intended changes. - Validate and simulate the updated configuration.
- Review and explicitly approve republication.
When updating arrays, include all intended rates and display groups because supplied arrays replace the existing arrays.
Important: Disabling a published rule removes its live checkout rates. Plan the interruption before disabling it. The rule will not serve rates again until republished.
Disable or Delete a Shipping Rule
| Operation | Effect | Required Access |
|---|---|---|
| Disable | Returns the rule to draft and stops its live rates. | Manage or Full access |
| Delete | Permanently removes the rule. | Full access |
Review the rule ID and current status before approving either operation.
Example prompt:
Find the shipping rule I want to stop. Show its ID and current status, then explain the proposed disable action. Wait for my approval.
Read or Update Shipping Settings
WowShipping MCP supports reading or updating shipping tax and debug settings through taxDefault and debugMode.
Reading requires Read only access or higher. Updating requires Manage or Full access.
These tools do not control every WooCommerce or WowShipping setting.
Free and Pro MCP Capabilities
WowShipping Free includes 15 MCP tools covering store lookups, validation, simulation, rule management and supported settings.
WowShipping Pro adds advanced shipping configurations and carrier connection capabilities when activated with a valid license.
| Capability | Free | Pro |
|---|---|---|
| Store, rule, zone, catalog and settings lookups | Yes | Yes |
| Rule validation and checkout simulation | Yes | Yes |
| Create, update, publish, disable and delete rules | Yes | Yes |
| Shipping tax and debug settings | Yes | Yes |
| Flat, flexible and free shipping | Yes | Yes |
| General and Cart rate conditions | Yes | Yes |
| Cart-based Advanced Display Rules | Yes | Yes |
| Sum matching tiers | Yes | Yes |
| Location-based rate conditions | No | Yes |
| Product, Customer, Location, schedule and Attribute display conditions | No | Yes |
| Delivery estimates | No | Yes |
| Logged-in and logged-out visibility | No | Yes |
| Handling fees | No | Yes |
| Stop/Deny actions | No | Yes |
| Highest, lowest, first or last tier aggregation | No | Yes |
| Live carrier rule configuration | No | Yes |
| Carrier connection tool | No | Yes |
Use get-rule-options and the store’s reported capabilities to confirm which options are available in your installation.
Available WowShipping MCP Tools
Navigate to WooCommerce → WowShipping → AI Tools → Tools to view each tool’s description, required permission and current status.
Read Tools
Required access: Read only, Manage or Full access.
| Tool | Description |
|---|---|
wowshipping/get-store-overview | Retrieve store currency, units, access mode and capabilities. |
wowshipping/list-rules | Find shipping rules by name, status and zone. |
wowshipping/get-rule | Retrieve a shipping rule and its configuration. |
wowshipping/list-zones | Retrieve shipping zones and their IDs. |
wowshipping/get-rule-options | Retrieve supported shipping methods, conditions and options. |
wowshipping/search-catalog | Find products, variations, categories and shipping classes. |
wowshipping/get-settings | Retrieve shipping tax and debug settings. |
wowshipping/validate-rule | Validate a shipping rule without saving. |
wowshipping/simulate-checkout | Preview shipping rates using cart items and a delivery address. |
Write Tools
Required access: Manage or Full access.
| Tool | Description |
|---|---|
wowshipping/create-rule | Create an unpublished shipping rule. |
wowshipping/update-rule | Update an existing draft shipping rule. |
wowshipping/publish-rule | Publish a reviewed shipping rule. |
wowshipping/disable-rule | Return a shipping rule to draft and stop its live rates. |
wowshipping/update-settings | Update shipping tax and debug settings. |
Delete Tool
Required access: Full access.
| Tool | Description |
|---|---|
wowshipping/delete-rule | Permanently delete a shipping rule. |
Pro Carrier Connection Tool
Requires an active WowShipping Pro license, the applicable permissions and consent scopes for OAuth connections.
| Tool | Description |
|---|---|
wowshipping/connect-carrier | Start carrier setup through the store’s WordPress form. |
Enter carrier credentials directly through the WordPress form, not in your AI conversation.
Carrier setup links become invalid when MCP access is turned Off.
What WowShipping MCP Cannot Do
The available MCP tools do not establish support for:
- Purchasing shipping labels.
- Tracking shipments.
- General WooCommerce order management.
- Editing published shipping rules directly without disabling them first.
- Requesting live carrier quotes through checkout simulation.
- Updating settings outside the supported shipping tax and debug options.
Live carrier rule configuration is available with Pro but live carrier quotes remain unsupported in MCP checkout simulations.
Use WowShipping MCP Safely
Start with Read only access to inspect, validate and simulate shipping rules.
Enable Manage when changes are necessary and Full access only when permanent deletion is required.
Review proposed changes, validate configurations and simulate representative checkout scenarios before publishing. Always verify the resulting shipping rates in your storefront.
For setup, permissions and credential security, see Getting Started with WowShipping MCP.