WooCommerce Subscriptions MCP · Pro
WooCommerce Subscriptions MCP: subscription support work, done by an agent.
A WooCommerce Subscriptions MCP server lets an AI agent handle the routine subscription requests: put one on hold, move a renewal date, change an item, cancel at term end. WP MCP does it through the Subscriptions API itself and keeps payment tokens out of the model's context.
Self-hosted · snapshot before every write · one-click undo
› Put subscription 4120 on hold while the customer replaces their card
woo-read subscriptions.list, curated, no gateway token
⛨ status, schedule, items and totals saved
woo-write subscriptions.update-status, confirm: true
✓ On hold. The customer email went out; the status is restorable.
What it is
What a WooCommerce Subscriptions MCP server does.
Subscription support is mostly small, careful edits: a customer's card is being replaced, a renewal should move to the first of the month, a box size changes. Each one touches a schedule that the plugin validates. A WooCommerce Subscriptions MCP server lets an agent make those edits under the plugin's own rules.
WP MCP works the Subscriptions API in-process, not its REST routes, so every response is a curated view with no order meta. No payment gateway customer id or token reference ever reaches the model. Nothing here charges a card or edits a gateway.
Subscription support is mostly small, time-sensitive requests: a customer is replacing a card, wants a renewal moved, or needs a box swapped. Each is a write that can email the customer or change what they pay. WP MCP handles them through the Subscriptions API itself, requires confirm:true on status changes and cancels, validates a new payment date against the schedule, and keeps gateway tokens out of what the model sees by returning a curated view with no order meta.
Read and change
What WP MCP can read and change in WooCommerce Subscriptions.
It can read
- Subscriptions, listed and read as a curated view
- Status, schedule, next payment date, line items, totals and addresses
It can change
- Move a subscription between active and on-hold
- Change the next payment date, validated against the rest of the schedule
- Edit line items, shipping and fees the way an order edit does
- Cancel at the end of the prepaid term, or immediately (opt-in)
These are the real ability and operation names the agent calls. TheWooCommerce Subscriptions AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
Which subscriptions renew in the next seven days?
Move the next payment on subscription 4120 to the first of next month.
Swap the monthly box on subscription 3987 for the large size and show me the new total.
Which subscriptions renew in the next seven days?
subscriptions.list returns a curated view with status, next payment date and totals, and no gateway token.
Put subscription 4120 on hold while the customer replaces their card.
subscriptions.update-status runs with confirm:true inside a snapshot of status, schedule, items, totals and addresses, since it can send customer emails.
Move the next payment on subscription 3987 to the first of next month.
subscriptions.update-next-payment validates the date against the rest of the schedule before writing.
Safety
Every WooCommerce Subscriptions write has a way back.
Every write runs inside a snapshot of the subscription's status, schedule, items, totals and addresses, so rollback-operation restores it. A status change or a cancel can send customer emails, so both need confirm:true, and cancel is destructive and stays off until the site opts in.
Snapshot before every write
No tool that writes can skip it. The before-state is saved first, the change is applied second.
One-click undo
Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.
No gateway tokens in the model
Reads are curated with no order meta, so no gateway customer id or payment token reaches the agent, and item edits are refused when the payment method cannot take amount changes.
Free or Pro
Part of WP MCP Pro.
WooCommerce Subscriptions support is part of WP MCP Pro, in the extended WooCommerce toolset. The free plugin includes the core WooCommerce tools for products, orders and reports.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect WooCommerce Subscriptions MCP in four steps.
- 01Install WP MCP
Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.
- 02Check the requirement
WooCommerce and WooCommerce Subscriptions active.
- 03Connect your client
Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.
- 04Ask for the change
Describe what you want done in WooCommerce Subscriptions. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.
Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.
Frequently asked
WooCommerce Subscriptions MCP: questions, answered.
What is WooCommerce Subscriptions MCP?
It is WooCommerce Subscriptions management for AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read subscriptions and change status, dates and items through the plugin's own API.
Can the agent see card details or payment tokens?
No. Subscription reads are a curated view with no order meta, so gateway customer ids and tokens are never returned.
Can it cancel a subscription?
Yes, once the site opts in. Cancel ends a subscription at the end of its prepaid term, or immediately when asked, and needs confirm:true because it sends emails.
Is a cancellation reversible?
Rollback puts the subscription record back. A gateway that keeps its own recurring profile has already cancelled it, and the emails have gone out, so the operation reports that caveat honestly.
Does it charge renewals?
No. Nothing in WP MCP charges a card or edits a payment gateway. Changing the next payment date reschedules the renewal that WooCommerce Subscriptions itself will run.
Can the agent cancel a subscription?
Yes, at the end of the prepaid term or immediately, but cancel is destructive and stays off until the site opts in, and it needs confirm:true.
What happens if the payment method cannot take amount changes?
Item edits are refused in that case, so an agent cannot change a total the gateway would not accept.
Does WooCommerce Subscriptions MCP work with Claude, Claude Code and Cursor?
Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the WooCommerce Subscriptions tools are available in every client the same way.
Keep exploring
MCP for WooCommerce Subscriptions →
Read and manage WooCommerce subscriptions over MCP, status, next payment, line items and cancellation, curated so no gateway token leaks, every write reversible.
FunnelKit MCP →
A FunnelKit MCP server lets an AI agent see how your funnels are put together and change them on request.
MemberPress MCP →
A MemberPress MCP server lets an AI agent answer questions about your membership site and adjust memberships and access rules.
LearnDash MCP →
A LearnDash MCP server lets an AI agent see a course as a tree and work on it: add a lesson, reorder topics, enroll a learner.
Rank Math MCP →
A Rank Math MCP server lets an AI agent read and write the SEO fields Rank Math manages, across as many posts as you point it at.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.