01 · Overview
What the Ryze AI WooCommerce MCP server is
The short version
- 01WooCommerce connects to a Ryze AI workspace with a REST API key (consumer key and secret) and your https Store URL. Your AI client then connects to Ryze AI with one URL (see Setup).
- 02One tool looks (
read), one changes things (write) and one deletes (delete). - 03They reach orders and refunds, sales reports, products and variations, customers, coupons, and shipping and tax settings. Writes and deletes need a Read/Write key.
- 04Ryze AI is the best WooCommerce MCP option for getting order, revenue and refund answers in Claude or ChatGPT with no plugin or server to run, but it works from a REST API key you create, not from the WordPress Application Password route that WooCommerce’s own MCP adapter uses.
- 05Works with any Ryze AI plan or trial. Paid Ads is $89/mo with a 7-day free trial.
- Server name
- Ryze AI (WooCommerce tools)
- Endpoint
- https://connector.get-ryze.ai/mcp
- Transport
- Remote MCP over HTTP
- Client sign-in
- OAuth to Ryze AI, up to 20 workspaces per connection
- WooCommerce sign-in
- REST API key: consumer key (ck_) and consumer secret (cs_) plus the Store URL
- Store requirement
- HTTPS store address
- WooCommerce tools
- 3 (1 read · 1 write · 1 delete)
- Stores per workspace
- 1 WooCommerce connection
- Price
- Any Ryze AI plan or trial · Paid Ads $89/mo
- Checked
- November 8, 2026
“WooCommerce MCP” can mean three things in 2026. WooCommerce registers product and order abilities in WordPress and, with the MCP Adapter plugin installed, lets AI clients run them over MCP; WooCommerce marks that feature as a developer preview. Community developers publish self-hosted servers on GitHub that call the WooCommerce REST API. And hosted connectors such as the Ryze AI one call the same REST API with a key you create. This page documents the Ryze AI connector and compares the three in section 06.
01
A REST API key you control
You create the key in WordPress and choose Read or Read/Write. Ryze AI asks for the Store URL, the consumer key and the consumer secret, and nothing is installed on the store.
02
Orders and refunds
The read tool reaches orders and refunds with GET requests, so the agent can list orders by status or date and look at what was refunded.
03
Sales reports
Revenue questions use the store's sales reports. Ryze AI counts revenue from completed and processing orders, minus refunds.
04
Products and variations
Products and their variations are readable, and with a Read/Write key price or stock can be updated when you ask.
05
Customers and coupons
Customers and coupons can be read. With a Read/Write key the agent can create a coupon, and delete one when you explicitly ask.
06
Shipping and tax settings
The read tool can open the store's shipping and tax settings, which helps when a margin or price question depends on them.
07
Order notes and status
With a Read/Write key the agent can add an order note or change an order's status. A read-only key rejects both.
08
Delete in its own tool
woocommerce__delete removes a coupon or product by path. It is a separate tool, so you can allow edits and hold deletes for approval.
02 · Tool reference
Three WooCommerce tools and the key each one needs
The read tool sends GET requests, the write tool sends POST or PUT requests and the delete tool removes an object by path. Writes and deletes are rejected when the store was connected with a read-only key.
| Tool | Access | What it does | Key needed |
|---|---|---|---|
woocommerce__read | read | Reads store data with GET requests to the WooCommerce REST API: orders and refunds, sales reports, products and variations, customers, coupons, and shipping and tax settings. | Read or Read/Write key |
woocommerce__write | write | Creates or updates WooCommerce objects with POST or PUT, such as coupons, products, order notes, order status, prices and stock. | Read/Write key |
woocommerce__delete | delete | Deletes a WooCommerce object by path, such as a coupon or product. Used only when you explicitly ask. | Read/Write key |
Tool names come from the Ryze AI connector’s source. No workspace had WooCommerce connected when this page was checked, so the live tool list was not seen. After you connect a store, open the connector’s tool list in your client to confirm it.
The WooCommerce resources behind the read tool
| Data | WooCommerce REST v3 resource | What comes back |
|---|---|---|
| Orders | orders, orders/{id}/refunds | Status, dates, line items, totals and refunds for each order |
| Sales reports | reports/sales, reports/top_sellers | Total sales, net sales and top sellers over a date range (date_min, date_max) |
| Products | products, products/{id}/variations | Names, prices, stock and variations |
| Customers | customers | Customer records and their details |
| Coupons | coupons | Codes, discount type, amount and limits |
| Settings | settings, shipping, taxes | Store options, shipping zones and tax rates |
Resource names are from the WooCommerce REST API reference, where each path sits under /wp-json/wc/v3/. Ryze AI lists the kinds of data the read tool reaches; the table shows where WooCommerce keeps each one.
A sales report request, as WooCommerce defines it
GET /wp-json/wc/v3/reports/sales?date_min=2026-10-01&date_max=2026-10-31The report endpoint takes a date range and returns totals for it. In chat you do not write the request: ask for revenue for October and the agent builds it. Ad and analytics tools on the same URL are documented on Google Ads MCP, Meta Ads MCP and Google Analytics MCP.
03 · Store use cases
Revenue, refunds, catalog and coupons in one chat
WooCommerce keeps its numbers inside the WordPress admin, where the built-in reports answer fixed questions. A chat lets you ask the question you actually have and follow it up. For revenue, Ryze AI counts completed and processing orders, minus refunds. The prompts below describe what comes back; the figures are always your own store’s.
- “Show daily revenue for the last 14 days from completed and processing orders, minus refunds.”
- “Which 10 products sold the most last month, and how many units of each?”
- “List orders that are still on hold and how long each has waited.”
- “Which products had the most refunds this quarter, and what share of their orders were refunded?”
- “Show customers with more than one order in the last 60 days.”
- “List the orders from the last 7 days with a refund and the refund total for each.”
- “List variable products where any variation is out of stock. Do not change anything yet.”
- “Raise the price of these 5 products by 5% and show each new price before saving.”
- “Set stock to 0 on the product I name and add an order note to its open orders.”
- “List active coupons with their discount type, amount and usage limit.”
- “Create a 15% coupon with the code I give you, limited to one use per customer.”
- “Delete the expired coupons I confirm, one by one.”
Blog articles are a different connection. WooCommerce covers store data, so to publish articles to a WordPress blog, connect WordPress as well, as the Ryze AI WordPress guide explains.
04 · Setup
Connect WooCommerce once, then add the URL to each client
Step 1: create a REST API key in WordPress
- 01In WordPress, go to WooCommerce, Settings, Advanced, REST API and click Add key.
- 02Pick Read for reporting only, or Read/Write if the agent should create or change things.
- 03Copy the consumer key (it starts with
ck_) and the consumer secret (it starts withcs_).
Step 2: connect the store in Ryze AI
- 01On the Integrations page in Ryze AI, click Connect on the WooCommerce card.
- 02Enter the Store URL (your https address, for example https://yourstore.com), the consumer key and the consumer secret.
- 03Click Continue.
Details are in the Ryze AI WooCommerce guide. You can also connect from inside Claude or ChatGPT with a one-time connection link.
Step 3: add the connector in Claude
- 01Go to Customize, Connectors.
- 02Choose + Add, then Add custom connector. Enter Ryze AI as the name and
https://connector.get-ryze.ai/mcpas the URL, then click Continue. - 03Keep the sign-in on OAuth (do not pick No sign in), click Add, then Connect.
- 04On the Ryze AI page, sign in, choose the workspace that holds WooCommerce and click Allow connection.
- 05Start a new chat. Claude keeps the tool list from the moment the connector is added, so if WooCommerce was connected afterwards, remove the connector, add it again and open a new chat.
Anthropic lists custom connectors on Free, Pro, Max, Ultra, Team and Enterprise plans, and Free allows one. On Team plans an Owner adds the connector under Organization settings, Connectors, and each member then clicks Connect.
ChatGPT
OpenAI documents custom MCP servers for Business and Enterprise/Edu on ChatGPT web, and read-only access for Pro; on Business only admins and owners can create them. Open Plugins, choose the plus button, then Add custom MCP server, name it Ryze AI, enter the URL, choose OAuth, create it, then sign in to Ryze AI and allow the workspace. Ryze AI’s own help page describes an older flow under Settings, Apps, Developer mode and Create app. Plan rules differ between those sources, so check OpenAI’s current article. ChatGPT freezes the tool list when the connection is made; after connecting WooCommerce later, remove the app and add it again.
Cursor and Claude Code
{ "mcpServers": {
"ryze": { "url": "https://connector.get-ryze.ai/mcp" }
} }claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope userCursor opens a sign-in window the first time a tool runs. In Claude Code type /mcp, choose ryze and finish sign-in in the browser. VS Code and other clients take the same URL; the developer page has each config.
05 · Keys and permissions
Read key or Read/Write key, and who can create one
| Who creates the key | A WordPress user with access to WooCommerce > Settings > Advanced > REST API. The key is generated for a WordPress user you pick, and WooCommerce says use of the API with the key follows that user's roles and capabilities. |
| Read key | Read permission is enough for reporting: orders, refunds, sales reports, products, customers, coupons and settings. Writes and deletes are rejected. |
| Read/Write key | Needed when the agent should create or change things: coupons, products, order notes, order status, price and stock, and deletes of coupons or products. WooCommerce also offers a Write-only level; the Ryze AI help center names Read and Read/Write. |
| What stops a key | WooCommerce says a key stops working if the WordPress user it belongs to is deleted, and keys are not transferred to another user. Revoke a key from the same REST API screen. |
| Key level | What the agent can do | What it cannot do | Use it for |
|---|---|---|---|
| Read | Orders, refunds, sales reports, products, customers, coupons, shipping and tax settings | Create, update, delete | Reporting and audits |
| Read/Write | Everything Read can, plus creating coupons, products and order notes, updating order status, price and stock, and deleting coupons or products | Nothing is blocked by the key itself, so use approvals | Store changes you ask for |
Key levels and the user rule are from the WooCommerce authentication docs; what each level allows in Ryze AI is from the Ryze AI help center, checked Nov 8, 2026. A key belongs to one WordPress user, so create it for a user whose reach you are comfortable handing to the agent.
Removing access
In WordPress, revoke the key on the same REST API screen. In Ryze AI, click View on the WooCommerce card and disconnect the store. In Claude, open Customize, Connectors, Ryze AI and click Disconnect, which cuts off every workspace at once.
06 · Compare
Ryze AI vs WooCommerce’s own MCP route and community servers
Three things called WooCommerce MCP
| Option | Built for | How you connect | Store data | Changes |
|---|---|---|---|---|
| Ryze AI hosted connector | Store owners and agencies who want store data in Claude or ChatGPT with nothing to host | REST API key and Store URL entered in Ryze AI, then OAuth sign-in from the client | Orders, refunds, sales reports, products, customers, coupons, settings | Coupons, products, order notes, order status, price and stock, deletes of coupons or products |
| WooCommerce MCP integration (developer preview) | Developers and store teams who can install a WordPress plugin | MCP Adapter plugin on the store, then a WordPress user and Application Password | Products and orders, order notes, through WooCommerce abilities | Create, update and delete products, update order status, add order notes |
| Community servers on GitHub | Developers who self-host | Varies by repo; techspawn/woocommerce-mcp-server asks for the site URL, consumer key and consumer secret in its environment | Depends on the repo | Depends on the repo |
WooCommerce says its MCP integration is a developer preview, that it needs the MCP Adapter plugin, and that the older /wp-json/woocommerce/mcp endpoint was removed in WooCommerce 11.3. Its docs also warn that order and customer operations can expose personal data. Sources: WooCommerce MCP docs and the techspawn/woocommerce-mcp-server repository, checked Nov 8, 2026.
The three side by side
| Ryze AI | WooCommerce MCP Adapter route | Community server (techspawn) | |
|---|---|---|---|
| Runs where | Hosted by Ryze AI, nothing installed on the store | On your WordPress site, through the MCP Adapter plugin | On your own machine or server, started by the client |
| Credentials | REST API key (ck_ and cs_) entered once in Ryze AI | WordPress Application Password for a dedicated user; WooCommerce says not to use a REST API key | Consumer key and secret in environment variables |
| Tools the client sees | 3: read, write, delete | 3 adapter tools that discover and run abilities | Its own tool list, which its README describes as covering products, orders, customers, shipping and taxes |
| Status | Available on any Ryze AI plan or trial | Developer preview, details may change | Open source, MIT, last push Nov 10, 2025 when checked |
| Clients | Claude, ChatGPT, Claude Code, Cursor, VS Code, Grok | Local clients that use STDIO or the remote proxy | Clients that can start a local Node.js process |
| Price | Any Ryze AI plan or trial. Paid Ads $89/mo, 7-day free trial | No WooCommerce charge listed | Free to use |
As published on Nov 8, 2026. WooCommerce marks its MCP feature as a preview, so check its docs before you decide.
Which to pick: if you can install a plugin and want WordPress to enforce permissions per ability, WooCommerce’s adapter route keeps everything on your own site. If you want to read the REST API from your own code or host the server yourself, a community server gives you the source. Ryze AI fits when you want store reports and edits in Claude, ChatGPT or Cursor without installing or hosting anything, and you are fine working from a REST API key.
07 · API limits
WooCommerce limits an agent runs into
| HTTPS stores only | Ryze AI accepts a store address that starts with https://. WooCommerce sends keys over HTTP Basic Auth on HTTPS and needs OAuth 1.0a on plain HTTP. |
| Pretty permalinks | WooCommerce says the REST API needs pretty permalinks; default permalinks will not work. |
| Page size | WooCommerce returns 10 items per page by default. A request can set per_page and page, and the X-WP-Total and X-WP-TotalPages headers give the totals, so a long list takes several pages. |
| Batch endpoints | WooCommerce offers batch endpoints for coupons, products and other objects. By default one batch handles up to 100 objects to create, update or delete. |
| Rate limits | The WooCommerce REST API reference lists no request rate limit. Limits that apply come from your host, a security plugin or a firewall in front of the store. |
| Error codes | WooCommerce documents 400 for a bad request, 401 for an authentication or permission error, 404 for a missing resource and 500 for a server error. |
| One store per workspace | A Ryze AI workspace holds one WooCommerce connection. To switch stores, click View, disconnect the current store and connect the other. |
| Client plans | Claude: any plan, with one custom connector on Free. ChatGPT: custom MCP servers on Business and Enterprise/Edu, and read-only on Pro, per OpenAI's help article. |
From the WooCommerce REST API reference and authentication docs, checked Nov 8, 2026, and the Ryze AI help center. Ryze AI does not publish whether its write tool uses WooCommerce batch endpoints.
08 · Approvals and safety
How you keep control of store changes
Approvals in the Ryze AI app
The Tool approvals setting in the Ryze AI chat starts on Skip all approvals. Approve write & delete holds every change for you while reads run freely; Manual approve holds every tool that touches your data.
Scheduled tasks
Scheduled tasks run without an approval step. If a task could change prices or stock, connect the store with a Read key.
Approvals in Claude
Under Customize, Connectors, Ryze AI, Tool permissions, leave the read tool on automatic and set write and delete to Needs approval. Claude then shows each change and waits.
Delete kept separate
Only woocommerce__delete removes coupons or products, so you can allow edits and keep deletes on approval.
Choose the key level
A Read key makes writes and deletes impossible. Use Read/Write only for the stretch of time you need changes.
Policies
Read the MCP privacy policy, the MCP terms, the security policy and the permissions guide.
09 · Errors and fixes
WooCommerce MCP errors and what causes them
| Message or symptom | Cause | Fix |
|---|---|---|
| "The store must be served over HTTPS" | The Store URL starts with http://. | Use the store's https:// address. |
| "Consumer keys start with ck_" or "Consumer secrets start with cs_" | The values are swapped or incomplete. | Copy both again from the WooCommerce REST API screen. |
| Updates are rejected | The key is read-only. | Create a new key with Read/Write, click View on the WooCommerce card to disconnect, then connect again with the new key. |
| WooCommerce tools are not in Claude or ChatGPT | WooCommerce was connected after the connector was added, and the client kept the old tool list. | Remove the Ryze AI connector, add it again and open a new chat. |
| Tools reply that a subscription is required | The workspace has no active Ryze AI plan or trial. | Start a plan or trial under Organization Settings, Billing, then retry. |
| Answers come from the wrong store | A workspace holds one WooCommerce connection, so the connected store answers. | Disconnect it under View and connect the right store, or use a separate workspace per store. |
| 401 from WooCommerce | WooCommerce lists 401 for incorrect keys or a permission error; the key may be revoked or its WordPress user deleted. | Create a new key for an active user and reconnect. |
| 404 "No route was found matching the URL and request method" | WooCommerce documents this rest_no_route error for a path that does not exist. Pretty permalinks being off is one cause WooCommerce names in its requirements. | Set permalinks to anything but Plain under Settings, Permalinks, then retry. |
| 501 Method Not Implemented | WooCommerce's docs mention this for stores behind ModSecurity. | Ask the host to review the ModSecurity rule for the REST API. |
| Long lists stop partway | WooCommerce pages results at 10 items by default. | Ask the agent to keep paging until X-WP-TotalPages is reached, or to set a larger per_page. |
The first six rows are Ryze AI connections, from the Ryze AI help center. The rest come from the WooCommerce REST API reference. More Ryze AI answers are in the integrations FAQ.
10 · FAQ
WooCommerce MCP server questions
What is a WooCommerce MCP server?
An MCP server lets AI clients such as Claude, ChatGPT and Cursor call WooCommerce through tools. WooCommerce has its own developer preview that runs through the MCP Adapter plugin on your site, and community servers exist on GitHub. Ryze AI runs a hosted one with 3 WooCommerce tools (read, write and delete) that connects with a REST API key.
Does WooCommerce have an official MCP server?
WooCommerce documents an MCP integration that it marks as a developer preview. It registers product and order abilities in WordPress and needs the MCP Adapter plugin, which WooCommerce does not bundle. Clients authenticate as a WordPress user with an Application Password. WooCommerce 11.3 removed the older /wp-json/woocommerce/mcp endpoint.
What is the WooCommerce MCP server URL?
The Ryze AI server is https://connector.get-ryze.ai/mcp, the same for every account, with no client ID to enter. WooCommerce’s own route uses an address on your store, https://yourstore.com/wp-json/mcp/mcp-adapter-default-server, with the MCP Adapter plugin active.
How do I connect WooCommerce to Claude?
Create a REST API key in WordPress under WooCommerce, Settings, Advanced, REST API. In Ryze AI click Connect on the WooCommerce card and enter the Store URL, consumer key and consumer secret. Then in Claude open Customize, Connectors, Add custom connector, paste https://connector.get-ryze.ai/mcp, click Connect, allow the workspace and open a new chat. Every client is covered in the setup section.
Can I use WooCommerce with ChatGPT?
Yes, through the same connector URL. OpenAI documents custom MCP servers for ChatGPT Business and Enterprise/Edu on the web, and read-only access on Pro, and on Business only admins and owners can create them. The Ryze AI help center lists different plans, so check OpenAI's current article for your plan.
Is the WooCommerce MCP connector free?
Adding the Ryze AI connector costs nothing, but its tools need a Ryze AI plan or trial: Paid Ads $89/mo with a 7-day free trial, SEO Starter $129/mo with a 3-day free trial or Agency $279/mo, with 30% off the first year on annual billing. WooCommerce lists no charge for its own MCP integration. See the pricing page.
What is the difference between a Read key and a Read/Write key?
A Read key is enough for reporting on orders, refunds, sales reports, products, customers, coupons and settings. A Read/Write key is needed to create coupons, products and order notes, update order status, price and stock, and delete coupons or products. Writes and deletes are rejected with a read-only key.
Can the AI change or delete things in my store?
With a Read/Write key, woocommerce__write creates coupons, products and order notes and updates orders and products, such as status, price or stock, and woocommerce__delete deletes coupons or products when you explicitly ask. The Ryze AI chat starts on Skip all approvals, so switch Tool approvals to Approve write & delete, or in Claude set write and delete to Needs approval.
Does it work for revenue and sales reports?
Yes. The read tool reaches orders, refunds and sales reports, and Ryze AI counts revenue from completed and processing orders, minus refunds. Ask for a date range and a breakdown, for example daily revenue for the last 14 days or refunds by product. It needs no plugin or server on your side and connects with a REST API key, not WordPress Application Passwords.
Does my store need HTTPS?
Yes. Ryze AI connects only to stores served over HTTPS, and the Store URL field expects an https address. WooCommerce sends REST API keys with HTTP Basic Auth over HTTPS and needs OAuth 1.0a on plain HTTP. The REST API also needs pretty permalinks.
Can I connect more than one WooCommerce store?
A Ryze AI workspace holds one WooCommerce connection. To switch stores, click View on the WooCommerce card, disconnect the current store and connect the other. For several stores at once, use a separate workspace for each.
Can it publish blog articles to my WooCommerce site?
No. The WooCommerce connection covers store data. To publish articles to a WordPress blog, connect WordPress as well; the Ryze AI WordPress guide covers it.
Why are WooCommerce tools missing in Claude or ChatGPT?
Claude keeps the tool list from the moment the connector is added, and ChatGPT freezes it when the connection is made. If WooCommerce was connected after the connector, remove the Ryze AI connector, add it again and start a new chat.
11 · Compatibility
Where the WooCommerce tools run
12 · Related
Other integrations and guides
Changelog
Page checked Nov 8, 2026. First version. The WooCommerce tool names, setup steps, key levels, REST API limits, error codes and the comparison with WooCommerce’s MCP integration and community servers were checked on this date against the Ryze AI help center, the Ryze AI connector source, developer.woocommerce.com, the WooCommerce REST API reference and GitHub. Tool names were not seen live because no workspace had WooCommerce connected.