Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.maxicore.ai/llms.txt

Use this file to discover all available pages before exploring further.

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

AbilityDescriptionCapabilityPlan
maxi/create-orderCreate an order with line items, customer, addresses, and status.manage_woocommercePro
maxi/get-orderGet full order details including items, totals, addresses, and payment.manage_woocommercePro
maxi/list-ordersList orders with filters for status, customer, and date range.manage_woocommercePro
maxi/update-order-statusChange an order’s status with an optional note.manage_woocommercePro
maxi/add-order-noteAdd a private or customer-visible note to an order.manage_woocommercePro

​
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. 
{
  "status": "processing",
  "date_after": "2025-01-01",
  "date_before": "2025-12-31",
  "per_page": 20
}
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. 
{ "order_id": 456 }

​
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. 
{
  "status": "pending",
  "customer_id": 5,
  "line_items": [
    { "product_id": 123, "quantity": 2 }
  ],
  "billing": {
    "first_name": "Jane",
    "last_name": "Doe",
    "email": "jane@example.com"
  }
}

​
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. 
{
  "order_id": 456,
  "status": "completed",
  "note": "Order fulfilled and shipped"
}
WooCommerce order statuses:
StatusMeaning
pendingOrder received, awaiting payment
processingPayment confirmed, fulfillment in progress
on-holdAwaiting manual review or payment verification
completedOrder fulfilled and closed
cancelledOrder cancelled by customer or admin
refundedOrder refunded
failedPayment failed or declined

​
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. 
{
  "order_id": 456,
  "note": "Customer requested gift wrapping",
  "customer_note": false
}
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.