E-commerce integration
WooCommerce Subscriptions AI agent tool reference
WP MCP Pro works WooCommerce Subscriptions through the plugin's own API in-process, not its wc/v3 routes, so every response is a curated view with no order meta, and no payment gateway customer or token reference ever reaches a model context. update-status moves a subscription between active and on-hold through WC_Subscription::update_status(), which applies Subscriptions' own transition rules and date handling; update-next-payment changes the next payment date through update_dates(), validated against the rest of the schedule and rescheduling the renewal; update-items edits line items, shipping and fees exactly as an order edit does, refused when the payment method cannot take amount changes; and cancel ends a subscription at the end of its prepaid term, or now with immediately:true. A status change or a cancel can send emails, so they need confirm:true, and cancel is destructive and off until a site opts in. Every write runs inside a snapshot of the subscription's status, schedule, items, totals and addresses, so rollback-operation restores it.
WooCommerce Subscriptions in plain language: WooCommerce Subscriptions MCP.
In practice
How WooCommerce Subscriptions work goes with an agent.
A WooCommerce subscription is its own record with a schedule of dates held in UTC (next payment, trial end, end), a parent order and a growing trail of renewal orders. Products reach it two ways: the older subscription and variable-subscription product types, and, in current Subscriptions releases, ordinary products sold through plans kept in product meta. WP MCP reads both kinds of product, lists the related orders by relation, and keeps every response a curated view, so support work such as moving a renewal date is done on the schedule the plugin itself validates.
Which products are sold on subscription, and what do their plans charge?
Runs subscriptions.products through woo-read. It lists the subscription and variable-subscription types with their terms, and products sold through plans with each plan priced, marked by sold_as. Nothing is written.
Show the renewal orders for subscription 4120, and the order it started from.
Runs subscriptions.renewal-orders, which defaults to the renewal relation, then again with relation parent. The other relations are switch, resubscribe and all. Both are reads.
Move the next payment on subscription 4120 to 1 December at 09:00 UTC.
Runs subscriptions.update-next-payment with next_payment as a future UTC date and time. Subscriptions validates it against the rest of the schedule and reschedules the renewal, after the subscription is snapshotted.
Add a 5 dollar handling fee to subscription 4120.
Runs subscriptions.update-items with a fee line, snapshotted first, and totals are recalculated unless recalculate:false. It is refused when the payment method cannot take amount changes.
What your AI can do
Real WooCommerce Subscriptions operations, every write reversible.
- List and read subscriptions as a curated view with no gateway tokens
- Move a subscription between active and on-hold under its own transition rules
- Change the next payment date, revalidated against the schedule
- Edit line items, shipping and fees the way an order edit does
- Cancel at the end of the prepaid term, or immediately
- Restore a subscription's status, schedule, items, totals and addresses
Example prompts
Example WooCommerce Subscriptions prompts.
Put subscription 4120 on hold while we sort out the customer's card.
Move the next payment on subscription 4120 to the first of next month.
Cancel subscription 4120 at the end of its current term.
Under the hood
The WooCommerce Subscriptions calls, under the hood.
woo-read({ op: "subscriptions.get", params: { id: 4120 } }), curated; no gateway token
woo-write({ op: "subscriptions.update-status", params: { id: 4120, status: "on-hold" }, confirm: true }), snapshotted; can email
Safety and access
What can be undone on WooCommerce Subscriptions, and what costs what.
Recoverable on WooCommerce Subscriptions
- Every subscription write runs under a snapshot of its status, schedule, items, totals and addresses.
- rollback-operation restores them, so a moved next payment date, an item edit or an on-hold status can be put back.
- A change that emailed the customer is restored in WooCommerce, but the email is not recalled.
WooCommerce Subscriptions limits and opt-ins
- subscriptions.cancel is destructive: it is off until a site enables it with the wpmcp_woo_op_enabled filter, needs confirm:true, and answers recoverable:false.
- Rolling back a cancel restores the subscription in WooCommerce, but a gateway that keeps its own recurring profile has already cancelled it and the cancellation emails have gone out.
- subscriptions.update-status only sets active or on-hold. Ending a subscription is cancel's job.
- Nothing here charges a card, edits a gateway or returns a gateway token.
Free or Pro: The subscriptions.* ops are Pro, part of the extended WooCommerce toolset behind woo-read, woo-write and woo-ops; the core WooCommerce tools for products, orders and reports stay free. Subscription writes are on by default for a licensed site, except that update-status needs confirm:true because it can email. Cancel is the one opt-in. Without WooCommerce Subscriptions active, the ops answer plugin_missing or plugin_inactive.
Part of WP MCP Pro
The WooCommerce Subscriptions integration is part of WP MCP Pro.
One Pro licence unlocks the WooCommerce Subscriptions tools and every other Pro integration on this site: Elementor deep editing, the other page builders, the forms adapter pack and more, 133 Pro tools in all. The free plugin still covers the rest of WordPress and the full snapshot and undo engine, so you can try the safety model before you buy.
Frequently asked
WooCommerce Subscriptions MCP: questions, answered.
Can an agent see payment credentials or gateway tokens?
No. Subscription reads are curated with no order meta, so no gateway customer id or payment token reaches the model. Nothing here charges a card or edits a gateway.
On WooCommerce Subscriptions, is a cancellation reversible?
Rollback puts the subscription back, but a gateway that keeps its own recurring profile has already cancelled it and the cancellation emails have gone out, so the op reports recoverable:false. Cancel is off until a site opts in and needs confirm:true.
Does the WooCommerce Subscriptions integration see products sold through subscription plans, not just the subscription product type?
Yes. subscriptions.products returns both: the legacy subscription and variable-subscription types with their terms, and simple or variable products sold through plans, each plan with its period, length, trial, sign-up fee and the price it charges for that product. The sold_as field says which kind a row is.
Why was my item edit on a subscription refused?
subscriptions.update-items is refused when the subscription's payment method cannot take amount changes, because changing the total would no longer match what the gateway is set to charge. Status and schedule changes are not affected by that rule. The refusal comes back before any snapshot or write.
What format does the next payment date take?
A future date and time in UTC, written YYYY-MM-DD HH:MM:SS. Subscriptions' own date handling checks it against the rest of the schedule, so a date that conflicts with it is refused rather than saved.
In WooCommerce Subscriptions, how do I find the right subscription to change?
subscriptions.list returns the newest first and filters by status (or a list of statuses), customer_id and product_id, with page and per_page up to 50. Each row has status, customer, total, period, next payment, end and line items. subscriptions.get then reads one in full.
Related integrations
More integrations for the same agent.
MCP for WooCommerce
FreeE-commerce, 9 tools.
MCP for WooCommerce Bookings
ProE-commerce, 3 tools.
MCP for WooCommerce Memberships
ProE-commerce, 3 tools.
MCP for FiboSearch
FreeE-commerce, 2 tools.
MCP for WP Simple Pay
FreeE-commerce, 1 tools.
MCP for Stripe
ProE-commerce, 2 tools.
Browse the full Integrations hub, or read more on WooCommerce Subscriptions MCP, MCP for WooCommerce and the WordPress MCP plugin.