WooCommerce MCP — Run Your Store with an AI Agent (40 Tools)

What is WooCommerce MCP?

WooCommerce MCP means running your online store by talking to an AI assistant instead of clicking through wp-admin. Cowboy MCP's WooCommerce integration exposes 40 store tools over the Model Context Protocol whenever WooCommerce is active, so an agent like Claude or ChatGPT can read and change products, orders, coupons, customers, and sales reports directly on your live store — with every write recorded and reversible.

MCP is the open standard that lets an AI client discover and call these tools. The same Cowboy MCP plugin that manages posts, users, and plugins lights up the WooCommerce tools automatically the moment WooCommerce is detected — there is nothing extra to install or configure. The agent sees 40 clearly named actions, each mapped to one real WooCommerce operation, and chooses the right one for what you ask.

What can an AI agent do in my store?

An agent can handle the everyday store work you would otherwise do by hand: create and update products, adjust prices, manage stock, process orders and refunds, issue coupons, look after customer records, and pull sales reports. Each of the 40 tools maps to a single real WooCommerce action, so the assistant fills in the details and reads back the result rather than guessing.

The tools group into six areas. The names below are the real tool identifiers the agent sees.

Products and variations

Tool	What it does
wp_woo_list_products	List and filter products by status, type, category, tag, SKU, or keyword
wp_woo_get_product	Read one product's full details, including type-specific fields
wp_woo_create_product	Create a simple, variable, grouped, or external product
wp_woo_update_product	Update any field on a product; only the fields you supply change
wp_woo_delete_product	Trash or permanently delete a product
wp_woo_list_variations	List every variation of a variable product
wp_woo_create_variation	Add a variation with its own attributes, price, and stock
wp_woo_update_variation	Change a variation's price, stock, or attributes
wp_woo_delete_variation	Remove a single product variation

Stock and reports

Tool	What it does
wp_woo_manage_stock	Bulk-set, increase, or decrease stock across one or many products
wp_woo_report_sales	Total revenue, orders, items sold, refunds, tax, and shipping for a date range
wp_woo_report_top_products	Rank best-selling products by quantity or revenue
wp_woo_report_orders_by_status	Count orders grouped by status
wp_woo_report_revenue_by_date	Break revenue down day by day
wp_woo_report_customer_stats	Summarize customer totals and top spenders

Orders and refunds

Tool	What it does
wp_woo_list_orders	List and filter orders by status, customer, or date range
wp_woo_get_order	Read an order's line items, addresses, and payment details
wp_woo_create_order	Create an order with line items, addresses, and coupons
wp_woo_update_order	Change an order's status, addresses, or meta
wp_woo_delete_order	Trash or delete an order
wp_woo_create_refund	Refund an order in full or by specific line items
wp_woo_list_order_notes	Read an order's customer and private notes
wp_woo_add_order_note	Add a customer-visible or internal note to an order

Coupons

Tool	What it does
wp_woo_list_coupons	List and search coupons
wp_woo_get_coupon	Read a coupon by ID or code
wp_woo_create_coupon	Create a coupon with discount type, amount, and usage limits
wp_woo_update_coupon	Change an existing coupon's fields
wp_woo_delete_coupon	Trash or delete a coupon

Customers

Tool	What it does
wp_woo_list_customers	List and search customers
wp_woo_get_customer	Read a customer's profile, addresses, and order stats
wp_woo_create_customer	Create a customer with email, name, and addresses
wp_woo_update_customer	Update a customer's details
wp_woo_get_customer_orders	Pull one customer's order history
wp_woo_get_customer_meta	Read a customer's raw user meta

Settings and tax

Tool	What it does
wp_woo_get_tax_rates	List tax rates by class
wp_woo_create_tax_rate	Add a new tax rate
wp_woo_list_shipping_zones	List shipping zones and their methods
wp_woo_list_payment_gateways	List payment gateways and their status
wp_woo_get_setting	Read any woocommerce_* setting
wp_woo_update_setting	Update a woocommerce_* setting, restricted to that namespace

Four real prompts, to make it concrete:

• "Cut the price of every product in the Clearance category by 25 percent, and show me the list before you apply it."
• "Refund order #1043 for the returned blue hoodie and add a private note explaining why."
• "Create a 15-percent-off coupon called WELCOME15, limited to one use per customer, expiring in 30 days."
• "Show me last week's revenue, order count, and the top five products by units sold."

How do bulk edits stay safe?

Letting an agent change hundreds of products at once is only sensible if you can preview and reverse it. Cowboy MCP wraps every WooCommerce write in the same safety layer it uses across the whole site: a dry-run preview before anything runs, a confirmation gate on destructive tools, a per-change undo journal, and one-click database checkpoints for the entire catalog.

• Dry run — every write tool, including wp_woo_update_product and wp_woo_manage_stock, can report exactly what it would change without touching a single row, so you see a bulk edit before it happens.
• Safe mode — destructive tools such as wp_woo_delete_product, wp_woo_delete_order, and wp_woo_create_refund will not run until you confirm; it is on by default.
• Undo journal — every write is captured as its own entry, so a wrong price change or a bad edit rolls back from the Activity tab without disturbing the rest of the catalog.
• Database checkpoint — take a one-click snapshot before a big migration and restore the store's database tables if something goes sideways.

Every call an agent makes is also written to the audit log, so you can review exactly which products, orders, or settings changed and when. The full guardrail model is covered on the security page.

What are WooCommerce MCP's limits?

Cowboy MCP drives WooCommerce through WooCommerce's own data layer, so it does what the store's core supports and nothing beyond it. It does not build storefront themes, design email templates, or set up a payment processor's account for you, and it moves money only through WooCommerce's standard refund flow. It reads and writes products, orders, coupons, customers, and settings — it is not a page builder or a marketing automation suite.

That boundary is deliberate. Because the tools sit on top of WooCommerce's core CRUD and reporting APIs, an agent's actions inherit WooCommerce's own validation and permission checks, and the results match what you would get in wp-admin. Extensions that add their own custom data still need their own tools; the 40 here cover the core store.

How do I set it up?

Setup takes about five minutes and needs no code. Install the Cowboy MCP plugin, make sure WooCommerce is active so the store tools register, then connect your AI assistant and start with a read-only request. The WooCommerce tools appear automatically once both plugins are running — there is nothing extra to switch on.

1. Install the plugin. In wp-admin, go to Plugins → Add New, search for "Cowboy MCP", and click Install then Activate. It is free on the WordPress.org plugin directory (opens in new tab) and needs WordPress 6.2+ and PHP 8.0+.
2. Connect your AI. Open Settings → Cowboy MCP and follow the guided setup. See how to connect WordPress to Claude or how to connect WordPress to ChatGPT for the full walkthrough.
3. Ask for something real. Start read-only — "list my ten best-selling products this month" — then let it act. Safe mode checks with you before anything destructive runs.

FAQ