diff --git a/kong/mcp/ai-mcp-proxy.yaml b/kong/mcp/ai-mcp-proxy.yaml
index cf73df2..fef1c46 100644
--- a/kong/mcp/ai-mcp-proxy.yaml
+++ b/kong/mcp/ai-mcp-proxy.yaml
@@ -21,10 +21,18 @@ config:
       idempotent_hint: true
       destructive_hint: false
       open_world_hint: false
-    description: Retrieve a paginated list of all customer orders with their status and details.
+    description: Retrieve a paginated list of all customer orders with their status and details. Filter
+      by status to find open commitments, e.g. In Process or On Hold.
     method: GET
     name: list-orders
     parameters:
+    - description: Only orders with this status, e.g. In Process, On Hold, Shipped, Cancelled, Disputed,
+        Resolved.
+      in: query
+      name: status
+      required: false
+      schema:
+        type: string
     - description: A page number within the paginated result set.
       in: query
       name: page
@@ -243,6 +251,18 @@ config:
                       id:
                         type: integer
                         readOnly: true
+                      requireddate:
+                        type: string
+                        format: date
+                        readOnly: true
+                        description: The order's required date. Denormalised from the order this line
+                          belongs to, so a caller filtering by product does not need a second call to
+                          learn what it commits to and by when.
+                      order_status:
+                        type: string
+                        readOnly: true
+                        description: The order's status, e.g. In Process, On Hold, Shipped, Cancelled,
+                          Disputed, Resolved.
                       quantityordered:
                         type: integer
                         maximum: 2147483647
@@ -263,11 +283,13 @@ config:
                         type: string
                     required:
                     - id
+                    - order_status
                     - orderlinenumber
                     - ordernumber
                     - priceeach
                     - productcode
                     - quantityordered
+                    - requireddate
   - annotations:
       title: Create a new order
       read_only_hint: false
@@ -436,6 +458,18 @@ config:
                       id:
                         type: integer
                         readOnly: true
+                      requireddate:
+                        type: string
+                        format: date
+                        readOnly: true
+                        description: The order's required date. Denormalised from the order this line
+                          belongs to, so a caller filtering by product does not need a second call to
+                          learn what it commits to and by when.
+                      order_status:
+                        type: string
+                        readOnly: true
+                        description: The order's status, e.g. In Process, On Hold, Shipped, Cancelled,
+                          Disputed, Resolved.
                       quantityordered:
                         type: integer
                         maximum: 2147483647
@@ -456,11 +490,13 @@ config:
                         type: string
                     required:
                     - id
+                    - order_status
                     - orderlinenumber
                     - ordernumber
                     - priceeach
                     - productcode
                     - quantityordered
+                    - requireddate
   - annotations:
       title: Get a specific order detail
       read_only_hint: true
@@ -504,6 +540,18 @@ config:
                 id:
                   type: integer
                   readOnly: true
+                requireddate:
+                  type: string
+                  format: date
+                  readOnly: true
+                  description: The order's required date. Denormalised from the order this line belongs
+                    to, so a caller filtering by product does not need a second call to learn what it
+                    commits to and by when.
+                order_status:
+                  type: string
+                  readOnly: true
+                  description: The order's status, e.g. In Process, On Hold, Shipped, Cancelled, Disputed,
+                    Resolved.
                 quantityordered:
                   type: integer
                   maximum: 2147483647
@@ -524,11 +572,13 @@ config:
                   type: string
               required:
               - id
+              - order_status
               - orderlinenumber
               - ordernumber
               - priceeach
               - productcode
               - quantityordered
+              - requireddate
   - annotations:
       title: Create a new order detail
       read_only_hint: false
@@ -580,6 +630,18 @@ config:
                 id:
                   type: integer
                   readOnly: true
+                requireddate:
+                  type: string
+                  format: date
+                  readOnly: true
+                  description: The order's required date. Denormalised from the order this line belongs
+                    to, so a caller filtering by product does not need a second call to learn what it
+                    commits to and by when.
+                order_status:
+                  type: string
+                  readOnly: true
+                  description: The order's status, e.g. In Process, On Hold, Shipped, Cancelled, Disputed,
+                    Resolved.
                 quantityordered:
                   type: integer
                   maximum: 2147483647
@@ -600,8 +662,10 @@ config:
                   type: string
               required:
               - id
+              - order_status
               - orderlinenumber
               - ordernumber
               - priceeach
               - productcode
               - quantityordered
+              - requireddate
diff --git a/openapi.yaml b/openapi.yaml
index 4646de1..37581c3 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -219,9 +219,15 @@ paths:
   /sales/v1/orders/:
     get:
       operationId: list_orders
-      description: Retrieve a paginated list of all customer orders with their status and details.
+      description: Retrieve a paginated list of all customer orders with their status and details. Filter by status to find open commitments, e.g. In Process or On Hold.
       summary: List all orders
       parameters:
+        - name: status
+          required: false
+          in: query
+          description: 'Only orders with this status, e.g. In Process, On Hold, Shipped, Cancelled, Disputed, Resolved.'
+          schema:
+            type: string
         - name: page
           required: false
           in: query
@@ -508,6 +514,15 @@ components:
         id:
           type: integer
           readOnly: true
+        requireddate:
+          type: string
+          format: date
+          readOnly: true
+          description: The order's required date. Denormalised from the order this line belongs to, so a caller filtering by product does not need a second call to learn what it commits to and by when.
+        order_status:
+          type: string
+          readOnly: true
+          description: 'The order''s status, e.g. In Process, On Hold, Shipped, Cancelled, Disputed, Resolved.'
         quantityordered:
           type: integer
           maximum: 2147483647
@@ -528,11 +543,13 @@ components:
           type: string
       required:
         - id
+        - order_status
         - orderlinenumber
         - ordernumber
         - priceeach
         - productcode
         - quantityordered
+        - requireddate
     OrderdetailRequest:
       type: object
       description: Order line items with product details