Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WOOCOMMERCE_KEY | Yes | Your WooCommerce REST API consumer key (starts with ck_). | |
| WOOCOMMERCE_URL | Yes | The URL of your WooCommerce store (e.g., https://yourstore.com). | |
| WOOCOMMERCE_SECRET | Yes | Your WooCommerce REST API consumer secret (starts with cs_). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ping | Validate WooCommerce connection and get store info (name, URL, currency, version, timezone). |
| list_products | List products. Filter by status (publish, draft, pending, private), category ID, search term, or on_sale flag. Orderby: date, id, title, price, popularity, rating. |
| get_product | Get full details for a product including pricing, inventory, categories, images, and attributes. |
| create_product | Create a product. Type: simple, grouped, external, variable. Categories: comma-separated IDs. |
| update_product | Update a product. Only provide fields you want to change. Set sale_price to empty string to remove sale. |
| delete_product | Delete a product. Set force=True for permanent deletion (bypass trash). |
| search_products | Search products by name or SKU. |
| list_product_categories | List product categories. Set parent=0 for top-level only. |
| list_orders | List orders. Filter by status (pending, processing, on-hold, completed, cancelled, refunded, failed), customer ID, or date range (ISO 8601). |
| get_order | Get full details for an order including line items, shipping, billing, and payment info. |
| create_order | Create an order. line_items: JSON array of {product_id, quantity} objects. Example: '[{"product_id": 42, "quantity": 2}]' |
| update_order_status | Update an order's status. Status: pending, processing, on-hold, completed, cancelled, refunded, failed. |
| list_order_notes | List all notes on an order (internal staff notes and customer-facing notes). |
| create_order_note | Add a note to an order. Set customer_note=True to make it visible to the customer. |
| create_refund | Create a refund for an order. Amount as string (e.g. '25.00'). |
| list_customers | List customers. Filter by role (all, administrator, customer) or search by name/email. Orderby: id, include, name, registered_date. |
| get_customer | Get full details for a customer including billing/shipping addresses and order stats. |
| create_customer | Create a new customer. Only email is required. |
| search_customers | Search customers by name or email. |
| list_coupons | List coupons. Optionally search by code. |
| get_coupon | Get full details for a coupon. |
| create_coupon | Create a coupon. discount_type: percent, fixed_cart, fixed_product. Amount as string (e.g. '10' for 10% or $10). |
| delete_coupon | Delete a coupon. force=True for permanent deletion. |
| get_sales_report | Get sales report. Period: week, month, last_month, year. Or provide date_min/date_max (YYYY-MM-DD). |
| get_top_sellers | Get top-selling products. Period: week, month, last_month, year. |
| get_order_totals | Get order counts by status (pending, processing, completed, etc.). |
| get_product_totals | Get product counts by type (simple, variable, grouped, external). |
| list_shipping_zones | List all shipping zones with their methods. |
| list_payment_gateways | List all payment gateways with their enabled status and settings. |
| list_tax_rates | List all tax rates. |
| list_webhooks | List all webhooks. |
| create_webhook | Create a webhook. Topics: order.created, order.updated, order.deleted, product.created, product.updated, product.deleted, customer.created, customer.updated, coupon.created, coupon.updated, etc. |
| delete_webhook | Delete a webhook. |
| get_system_status | Get WooCommerce system status — versions, database, active plugins, server environment, and store diagnostics. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |