Getting Started with WowShipping MCP

WowShipping AI Tools connects your WooCommerce shipping engine to AI assistants such as ChatGPT, Claude and Gemini using the Model Context Protocol (MCP).

Using natural-language prompts, you can retrieve shipping information, validate rules, simulate checkout rates and manage supported shipping rules and settings.

Requirements

  • WordPress 6.9 or later with the Abilities API available.
  • WooCommerce installed and activated.
  • A WowShipping version that supports AI Tools.
  • The standalone WordPress MCP Adapter plugin installed and activated.
  • A WordPress account with the manage_options capability, normally an administrator.
  • An AI application that supports custom MCP connections.

Core MCP tools are available in WowShipping Free. Additional Pro capabilities require WowShipping Pro to be active with a valid license.

Account capability requirements apply to both Free and Pro.

Choose Your Connection Method

AI ApplicationConnection MethodAuthentication
ChatGPT, Claude, GeminiRemote MCPOAuth
Claude DesktopRemote MCP or local bridgeOAuth or application password
Cursor, WindsurfLocal bridgeApplication password
VS CodeVS Code local bridge configurationApplication password
Claude Code, Gemini CLIDirect HTTPApplication password

Remote MCP connections require a publicly accessible HTTPS website and cannot access localhost.

For locally hosted websites, use a compatible desktop or CLI application that can reach your site and supports application-password authentication.

Using another MCP client

You can connect through other AI apps that support custom MCP servers and tool calls. Check that your app supports the connection and authentication method you plan to use. After connecting, run the read-only test prompt to confirm that the app can call the plugin’s tools before enabling write access.

For setup instructions and requirements, see the official guides for Codex, Google Antigravity, Grok Build, and Perplexity custom connectors.

Step 1: Configure MCP Access

Navigate to WooCommerce → WowShipping → AI Tools → Access Mode.

Select an access mode, click Save access mode and check Current Access.

Access ModeLookups, Validation & SimulationCreate, Update, Publish & DisableDelete
OffNoNoNo
Read onlyYesNoNo
ManageYesYesNo
Full accessYesYesYes

Start with Read only. You can validate shipping rules and simulate checkout rates without allowing changes to your store.

OAuth consent scopes and WordPress account permissions also apply alongside the selected access mode.

Step 2: Check System Readiness

Under System Readiness, check the availability of:

  • WordPress 6.9+ and the Abilities API.
  • WooCommerce.
  • WordPress MCP Adapter.
  • Pretty permalinks.

To enable pretty permalinks, navigate to Settings → Permalinks and select a structure other than Plain.

Resolve any reported issues before connecting.

Step 3: Copy Your MCP Server Address

Copy the MCP server address from the AI Tools page.

A typical WowShipping MCP endpoint looks like this:

https://example.com/wp-json/wtrs/mcp

Always use the address displayed on your website. The WowShipping endpoint uses wtrs, not wowshipping.

Step 4: Connect Your AI Assistant

Under Connect an AI assistant, select your preferred application and follow the corresponding guide:

You must save an enabled access mode before connecting.

Web assistants use WordPress sign-in and OAuth authorization. Compatible desktop and CLI applications can use application passwords.

Step 5: Verify Your Connection

Copy the prompt under Confirm your AI can read this store and paste it into your AI assistant.

Alternatively, replace the example address in this prompt with your own website:

Use WowShipping to read my store at https://example.com (the get-store-overview tool). Tell me the store currency and how many shipping rules it returns. If it fails, show me the error and what to do next. Do not change anything.

Confirm that your assistant calls a WowShipping tool and returns actual store information.

A general explanation of WowShipping does not verify the connection. A successful read also does not verify Manage or Full access permissions.

Choosing a model

For complex requests that involve several steps, we recommend using a reasoning model or selecting a higher reasoning setting if your AI app offers one. A standard model is usually enough for simple lookups. Review any proposed changes before approving them.

Learn more about reasoning models.

Review Changes Before Publishing

Before allowing an AI assistant to modify shipping rules:

  • Review the proposed configuration.
  • Validate the draft and simulate representative checkout scenarios.
  • Approve publication after reviewing the results.
  • Test unfamiliar changes on staging and maintain backups.

Publishing can affect the shipping rates available to customers. Full access also allows permanent rule deletion.

Disconnect or Disable MCP Access

Disconnect an Individual App

Under Connected apps, click Disconnect beside the application.

The app loses its WowShipping access immediately and must be authorized again to reconnect.

Disable All MCP Access

Select Off under Access Mode and click Save access mode.

This blocks all WowShipping MCP calls and revokes existing OAuth connections for the site’s WowShipping resource across users, clients and scopes. Access tokens, refresh tokens, unused authorization codes, pending consent and carrier setup links become invalid.

Re-enabling MCP requires fresh OAuth consent.

Revoke Application Passwords

Disabling MCP does not revoke WordPress application passwords. They may still authorize other WordPress APIs and work with WowShipping again after MCP is enabled.

To revoke them, navigate to Users → Profile → Application Passwords, revoke the relevant password and remove the saved credentials from your application.

Review MCP Tool Activity

The Recent MCP Tool Activity section records up to 100 entries from the last 30 days.

Entries include the time, tool, outcome, user ID and redacted request and response previews, including errors. Each preview is limited to 2,000 bytes.

Repeated calls with the same user, tool and outcome within one minute are suppressed. Discovery, OAuth traffic and requests rejected before tool execution are not recorded.

Security and Data Privacy

WowShipping does not make model API calls itself. Connected AI applications receive tool results and control how that information is subsequently used.

Connect only trusted AI services and review their privacy policies. Use test delivery addresses for checkout simulations whenever real customer information is unnecessary.

Activity-log redaction masks shipping-address, credential, contact and carrier-connection fields or links. Carrier-connection request arguments are omitted. However, personal information entered in generic rule-condition values may still appear in previews.

Never share passwords, tokens, encoded credentials or unnecessary customer information in chats, screenshots or support requests.

Enter carrier credentials directly through your store’s WordPress form.

What’s Next?

Explore What You Can Do with WowShipping MCP for supported capabilities, tools and example prompts.

For connection issues, see Troubleshooting WowShipping MCP Connections.