Skip to main content
Order management abilities let you interact with WooCommerce orders through your AI agent — creating orders programmatically, fetching full order details including line items and billing addresses, filtering orders by status or date, updating order statuses, and adding notes visible to your team or your customers. All order abilities require an active Pro plan, WooCommerce to be installed and active, and the manage_woocommerce capability on the connected WordPress user.
All WooCommerce order abilities require WooCommerce to be active and a Pro plan license. The connected WordPress user must have the manage_woocommerce capability — typically assigned to the Shop Manager or Administrator role.

All order abilities

Key ability examples

maxi/list-orders

List orders and filter by status, date range, customer, or any supported parameter. Combine filters to narrow results for reporting or bulk operations.
To analyze revenue, top products, or order trends, use maxi/list-orders with date filters and compute your metrics from the returned data. There are no dedicated WooCommerce reporting commands — all analytics work from order data.

maxi/get-order

Retrieve full details for a single order — line items, quantities, totals, billing and shipping addresses, payment method, and order meta.

maxi/create-order

Create a new order with line items, a customer ID, billing address, and an initial status. All fields beyond line_items are optional and can be omitted when not needed.

maxi/update-order-status

Change an order’s status and optionally attach a note explaining the transition. The note is added to the order’s internal history.
WooCommerce order statuses:

maxi/add-order-note

Add a note to an order. Set customer_note to true to make the note visible to the customer in their order history; leave it false (the default) for an internal-only note.
Internal notes (where customer_note is false) appear only in the WooCommerce admin order screen. Customer-facing notes (where customer_note is true) are emailed to the customer and shown in their account’s order history.

Revenue reporting

WooCommerce does not expose dedicated analytics commands through the MCP adapter. To answer questions about revenue, top-selling products, or order trends, use maxi/list-orders with date filters and compute the metrics from the returned data. For per-product lifetime sales figures, read the total_sales meta value via maxi/get-meta on the product post.
Do not attempt to run wc report commands — that WP-CLI subcommand does not exist in WooCommerce. Use maxi/list-orders with date filters for all revenue and order trend analysis.