diff --git a/kong/mcp/ai-mcp-proxy.yaml b/kong/mcp/ai-mcp-proxy.yaml
index 054ced2..cf73df2 100644
--- a/kong/mcp/ai-mcp-proxy.yaml
+++ b/kong/mcp/ai-mcp-proxy.yaml
@@ -359,9 +359,30 @@ config:
       destructive_hint: false
       open_world_hint: false
     description: Retrieve a paginated list of all order line items with product and quantity information.
+      Filter by product code to find what is committed on a reference, and by order status to count only
+      orders still open.
     method: GET
     name: list-order-details
     parameters:
+    - description: Only lines for this product reference.
+      in: query
+      name: productcode
+      required: false
+      schema:
+        type: string
+    - description: Only lines belonging to this order.
+      in: query
+      name: ordernumber
+      required: false
+      schema:
+        type: integer
+    - description: Only lines whose order has this status, e.g. In Process, On Hold, Shipped, Cancelled.
+        An order that is Shipped or Cancelled commits no stock.
+      in: query
+      name: ordernumber__status
+      required: false
+      schema:
+        type: string
     - description: A page number within the paginated result set.
       in: query
       name: page
diff --git a/openapi.yaml b/openapi.yaml
index 07d324a..4646de1 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -35,9 +35,27 @@ paths:
           description: ""
     get:
       operationId: list_order_details
-      description: Retrieve a paginated list of all order line items with product and quantity information.
+      description: Retrieve a paginated list of all order line items with product and quantity information. Filter by product code to find what is committed on a reference, and by order status to count only orders still open.
       summary: List all order details
       parameters:
+        - name: productcode
+          required: false
+          in: query
+          description: Only lines for this product reference.
+          schema:
+            type: string
+        - name: ordernumber
+          required: false
+          in: query
+          description: Only lines belonging to this order.
+          schema:
+            type: integer
+        - name: ordernumber__status
+          required: false
+          in: query
+          description: 'Only lines whose order has this status, e.g. In Process, On Hold, Shipped, Cancelled. An order that is Shipped or Cancelled commits no stock.'
+          schema:
+            type: string
         - name: page
           required: false
           in: query