Get the plugin
WP MCP/Integrations/E-commerce

E-commerce integration

WooCommerce AI agent tool reference

WP MCP speaks WooCommerce natively. On the free tier an AI agent can create and update products, variations, coupons and tax rates, change prices and stock, move orders through statuses, add notes, pull sales reports, and import products in two steps: plan-product-import shows every create, update and skip before anything is written, and apply-product-import writes exactly that plan as one undoable session. Pro adds a deep operations catalog (woo-ops, woo-read, woo-write) that runs in-process or through the store's own wc/v3 routes: order create and edit, shipping zones and methods, webhooks, payment gateway settings with every secret masked, product review moderation, totals reports, the system status report, and brands. Every write that changes existing state is snapshotted first, HPOS- and CPT-safe, so a wrong price or a mis-flipped order is one click from restored.

create-productupdate-productupdate-order-statusget-sales-reportplan-product-importapply-product-importwoo-opswoo-readwoo-write

In practice

How WooCommerce work goes with an agent.

A WooCommerce store is several kinds of data at once: products and variations as posts, orders in either the legacy post table or HPOS tables, and settings spread across options. Agents asked to "fix prices" or "ship the paid orders" touch all of them. The free tools cover the daily catalog and order work with a snapshot under each write, and a two-step product import that shows a diff before anything is written. Pro adds a catalog of further operations through three tools, which keeps the tool list short on a store that already has a lot of plugins.

Raise the price of every product in the Summer category by 8% and list what changed.

Runs list-products, then bulk-update-products in batches of up to 50 items. Each item goes through update-product or update-variation with its own snapshot, one failing item does not stop the others, and the whole batch shares one session_id so rollback-session undoes all of it.

Here is a spreadsheet of 60 products. Import it, but show me the changes first.

Runs plan-product-import, which matches rows to existing products by SKU and returns each row as create, update with a field diff, skip or error, writing nothing. After you approve, apply-product-import rebuilds the plan, refuses if anything moved, needs confirm:true above 20 writes, and runs as one session.

Mark orders 1041 and 1042 as completed and add a note that they shipped Monday.

Runs update-order-status for each order, validated against the statuses the store registers, then add-order-note. The status change is snapshotted as an order, so it restores exactly on both HPOS and legacy storage. The note is additive.

Add free shipping over 75 dollars to the US zone and check which payment gateways are enabled.

Pro. woo-write runs shipping.add-method with the zone id and free_shipping, snapshotting the whole zone first. woo-read runs gateways.list, with every key, secret and token masked in the response.

What your AI can do

Real WooCommerce operations, every write reversible.

  • Create and update products, variations, prices, and stock
  • Plan a product import, review the diff, then apply it as one undoable session
  • List and inspect orders; change status and add notes
  • Pro: create and edit orders without ever calling a payment gateway
  • Pro: manage shipping zones and the flat rate, free shipping and local pickup methods
  • Pro: create, pause and delete webhooks, with signing secrets masked and https-only delivery URLs
  • Pro: read payment gateways with every key, secret and token masked, and change their non-secret settings
  • Pro: check Stripe, WooPayments and PayPal Payments health: test mode, connection and webhook status, no keys returned
  • Pro: approve, hold, spam, trash, edit and reply to product reviews
  • Pro: sales, top seller, order, customer and coupon totals reports, aggregate figures only
  • Pro: read the system status report with secrets masked and run allowlisted maintenance tools
  • Pro: create, assign and unassign product brands
  • Restore an exact price, order, zone or review, or a whole session

Example prompts

Example WooCommerce prompts.

Put the 14 summer products on sale at 10% off.

Plan an import from this product list and show me what would change before you write anything.

Add free shipping over $75 to the US zone.

Approve the pending five-star reviews and reply to the one-star ones with an apology.

Under the hood

The WooCommerce calls, under the hood.

wpmcp, woocommerce

update-product({ id: 512, sale_price: "44.10" }), snapshotted; exact price restorable

woo-write({ op: "shipping.add-method", params: { zone_id: 1, method_id: "free_shipping" } }), Pro; whole-zone snapshot

woo-read({ op: "gateways.list" }), Pro; every secret field masked

Safety and access

What can be undone on WooCommerce, and what costs what.

Recoverable on WooCommerce

  • update-product, update-variation, update-order-status, coupons and tax rates are snapshotted first, and rollback-operation puts back the exact prior price, stock, status or rate.
  • A bulk-update-products batch and an apply-product-import run each share one session, so rollback-session reverses the whole pass.
  • On Pro, an order edit is snapshotted as the full order, a shipping change as the whole zone, a gateway change as the one option, and a review change as the full comment with its rating.
  • A product, coupon or tax rate deleted through the opt-in delete tools is snapshotted and restorable.

WooCommerce limits and opt-ins

  • delete-product, delete-variation, delete-coupon and delete-tax-rate are off until a site opts in with their wpmcp_enable_* filters, and each needs confirm:true.
  • Pro: destructive woo-write operations are off until the wpmcp_woo_op_enabled filter allows them, and also need confirm:true.
  • Pro: refunds.create is snapshotted but reports recoverable:false. The order status comes back on rollback, the money does not.
  • Pro: system-status maintenance tools rebuild derived data and cannot be rolled back, and each response says so.
  • Pro: order create and edit never call a payment gateway. set_paid and transaction_id are refused.

Free or Pro: Free covers the store tools: products, variations, coupons, tax rates, orders and notes, low-stock lists, sales reports, bulk-update-products (up to 50 items per call) and the plan then apply product import (up to 100 rows per call). Pro adds woo-ops, woo-read and woo-write: order create and edit, shipping zones and methods, webhooks, gateway settings, reviews, report totals, system status, brands, customers, refunds and store settings through the store's own wc/v3 routes.

In the free plugin

The WooCommerce integration is in the free plugin.

The core WooCommerce tools ship in the free, GPL plugin with the full snapshot and undo engine, and no trial clock. Pro adds 133 more tools, including Elementor deep editing, the other page builders, the forms adapter pack and, for some integrations, extra operations. The pricing page lists what each tier includes.

Frequently asked

WooCommerce MCP: questions, answered.

Is the WooCommerce integration free?

The core store tools are free: products, variations, coupons, tax rates, orders and status, notes, sales reports and the two-step product import. The deep operations catalog (woo-ops, woo-read, woo-write) with order editing, shipping, webhooks, gateways, reviews, reports, system status and brands is part of WP MCP Pro.

Can an agent see or change payment credentials?

No. Gateway reads mask every key, secret, password, token and password-type field, and gateways.update refuses secret fields outright. Order create and edit never call a payment gateway, and set_paid and transaction_id are refused. Setting a credential stays in the store admin screen.

Is everything undoable?

Every write that changes or removes existing state is snapshotted first. A few are honest exceptions and say so with recoverable:false: a refund (the status comes back, the money does not), system status tools (they rebuild derived data), and plain creates, which report the op that removes them. Destructive ops are off until a site opts in and need confirm:true.

Does the WooCommerce integration work with HPOS?

Yes. The order tools go through WooCommerce's order objects instead of assuming a table, and order snapshots restore through the same setters, so the same calls work on legacy post storage and on High-Performance Order Storage.

How big can an import be?

plan-product-import accepts up to 100 rows per call by default and apply-product-import asks for confirm:true above 20 writes. Both limits are filterable. A larger catalog is split into several plans, each a separate undoable session. Image URLs go through the guarded remote media download.

What happens if a product changes between plan and apply?

apply-product-import rebuilds the plan before writing and refuses if a matched product was edited, a SKU was taken or a category was removed in between. The plan carries a hash of the rows and of each matched product, so a stale approval never writes.

Can the WooCommerce integration see customer names and emails in reports?

Not in the Pro report operations. reports.sales, top-sellers, orders, customers and coupons return aggregate figures only. Review listings leave out the reviewer's email and IP, and order responses leave out order meta, the transaction id and the customer IP and user agent.

Can the WooCommerce integration change webhooks safely?

On Pro, webhooks.create and update take only public https delivery URLs that pass an SSRF guard, and refuse custom action topics. The signing secret is write-only and masked in every response. A webhook always delivers as the user who created it.

Is there an AI agent for WooCommerce?

Yes, through WP MCP rather than WooCommerce itself. An agent you choose, such as Claude or Cursor, can create and update products, variations, prices, and stock. WP MCP is a separate plugin, not a built-in AI feature of WooCommerce. On the undo side: update-product, update-variation, update-order-status, coupons and tax rates are snapshotted first, and rollback-operation puts back the exact prior price, stock, status or rate.

Point your AI at WooCommerce.