List Products is a WordPress ability from WooCommerce — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Products
Read-onlyList and filter your WooCommerce product catalog with paging, search, and attribute-based filters.
Requires the WooCommerce plugin active on WordPress 6.9+, with the experimental 'mcp_integration' feature flag enabled (WooCommerce > Settings > Advanced > Features). Abilities are only registered for requests hitting WooCommerce's own /woocommerce/mcp REST endpoint, and each request must authenticate with a WooCommerce REST API key (consumer_key:consumer_secret) sent via the X-MCP-API-Key header over HTTPS — the key's read/write permission scope must match the HTTP method used.
What it does
This ability retrieves a paginated list of products from your WooCommerce store by calling the same collection query used by the wc/v3/products REST endpoint. You can filter results by status, product type, SKU, category or tag ID, featured flag, stock status, on-sale flag, and a min/max price range, and page through results with per_page/page. Because the ability is marked read-only in its registration, it can only fetch data — it never modifies the catalog. Results are returned wrapped as a data array of product objects matching WooCommerce's product REST schema.
See it in action
You ask your AI assistant
"Show me all published products in the 'Outerwear' category that are currently on sale, sorted by price."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| search | string | No | Limit results to products matching a search term. |
| status | string | No | Limit results to products with a specific status (draft, pending, private, publish, future, trash, or 'any', the default). |
| type | string | No | Limit results to a specific product type (e.g. simple, grouped, external, variable). |
| sku | string | No | Limit results to products with specific SKU(s); comma-separated. |
| category | string | No | Limit results to products assigned a specific category ID. |
| tag | string | No | Limit results to products assigned a specific tag ID. |
| featured | boolean | No | Limit results to featured products. |
| stock_status | string | No | Filters products by stock status — one of instock, outofstock, or onbackorder. |
| on_sale | boolean | No | Limit results to products currently on sale. |
| min_price | string | No | Limit results to products at or above this price. |
| max_price | string | No | Limit results to products at or below this price. |
| per_page | integer | No | Number of products to return per page. |
| page | integer | No | Which page of results to return. |
Returns
An object with a data array of product records (id, name, slug, type, status, sku, price, regular_price, sale_price, stock data, categories, images, and other fields from the WooCommerce product schema).
Permission
Registered as a read-only (GET) operation. The MCP request must authenticate with a WooCommerce REST API key (consumer_key:consumer_secret) sent in the X-MCP-API-Key header over HTTPS, and the key's permission scope must be 'read' or 'read_write'.
More WooCommerce abilities
Create Order
Create a new WooCommerce order with customer, billing/shipping, and line item details.
Create Product
Create a new WooCommerce product with a name, price, description, and other catalog attributes.
Delete Product
Permanently delete a product from the WooCommerce catalog.
Get Order
Fetch full details for a single WooCommerce order by its ID.
Get Product
Fetch full details for a single WooCommerce product by its ID.
List Orders
List and filter WooCommerce orders by status, customer, product, or date range.