What Can You Do with WowShipping MCP?

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

CapabilityWhat You Can DoExample Prompt
Store overviewRetrieve currency, units, access mode and capabilities.Show my shipping store overview. Do not change anything.
Rules and zonesFind shipping rules and zones and inspect rule configurations.List my shipping zones and draft rules with their IDs.
Rule options and catalogRetrieve supported methods, conditions, products, variations, categories and shipping classes.Show supported shipping conditions and find my shipping classes.
ValidationValidate a rule without saving it.Validate this proposed shipping rule and explain any errors.
Checkout simulationPreview rates for a saved rule or unsaved draft.Ask for the required inputs and simulate this shipping scenario.
Rule managementCreate drafts, update, publish, disable and delete rules when authorized.Prepare an unpublished shipping rule and show it for review.
SettingsRetrieve 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 -1 for global rules or zone 0 for 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 everyValue and an exact supported Cart: 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.

InputRequirement
Cart items1–50 distinct cart lines.
Product IDA published productId for each cart line.
QuantityAn integer from 1 to 1,000 per line.
Product variationThe parent productId and a matching published variationId.
Shipping addressTwo-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:

  1. Retrieve supported rule options.
  2. Prepare the proposed rule configuration.
  3. Validate the configuration.
  4. Create an unpublished rule.
  5. Simulate representative checkout scenarios.
  6. 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.

  1. Identify the rule and approve the proposed changes.
  2. Call disable-rule to return it to draft.
  3. Retrieve the rule’s latest revision.
  4. Update the draft using its id, expectedRevision, a unique requestId and the intended changes.
  5. Validate and simulate the updated configuration.
  6. 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

OperationEffectRequired Access
DisableReturns the rule to draft and stops its live rates.Manage or Full access
DeletePermanently 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.

CapabilityFreePro
Store, rule, zone, catalog and settings lookupsYesYes
Rule validation and checkout simulationYesYes
Create, update, publish, disable and delete rulesYesYes
Shipping tax and debug settingsYesYes
Flat, flexible and free shippingYesYes
General and Cart rate conditionsYesYes
Cart-based Advanced Display RulesYesYes
Sum matching tiersYesYes
Location-based rate conditionsNoYes
Product, Customer, Location, schedule and Attribute display conditionsNoYes
Delivery estimatesNoYes
Logged-in and logged-out visibilityNoYes
Handling feesNoYes
Stop/Deny actionsNoYes
Highest, lowest, first or last tier aggregationNoYes
Live carrier rule configurationNoYes
Carrier connection toolNoYes

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.

ToolDescription
wowshipping/get-store-overviewRetrieve store currency, units, access mode and capabilities.
wowshipping/list-rulesFind shipping rules by name, status and zone.
wowshipping/get-ruleRetrieve a shipping rule and its configuration.
wowshipping/list-zonesRetrieve shipping zones and their IDs.
wowshipping/get-rule-optionsRetrieve supported shipping methods, conditions and options.
wowshipping/search-catalogFind products, variations, categories and shipping classes.
wowshipping/get-settingsRetrieve shipping tax and debug settings.
wowshipping/validate-ruleValidate a shipping rule without saving.
wowshipping/simulate-checkoutPreview shipping rates using cart items and a delivery address.

Write Tools

Required access: Manage or Full access.

ToolDescription
wowshipping/create-ruleCreate an unpublished shipping rule.
wowshipping/update-ruleUpdate an existing draft shipping rule.
wowshipping/publish-rulePublish a reviewed shipping rule.
wowshipping/disable-ruleReturn a shipping rule to draft and stop its live rates.
wowshipping/update-settingsUpdate shipping tax and debug settings.

Delete Tool

Required access: Full access.

ToolDescription
wowshipping/delete-rulePermanently delete a shipping rule.

Pro Carrier Connection Tool

Requires an active WowShipping Pro license, the applicable permissions and consent scopes for OAuth connections.

ToolDescription
wowshipping/connect-carrierStart 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.