Continente MCP

Overview Schema Source Related Servers Discussions Admin
List orders

list_orders
Read-onlyIdempotent
Retrieve recent Continente orders newest first, including product lines and order IDs, with options to limit details and paginate using a cursor.
Instructions

List recent orders, newest first, with their product lines. Each order has an orderId for get_order. Use detailLimit or includeLines: false to read fewer details, and pass the returned nextCursor as cursor to continue.
Input Schema

TableJSON Schema
Name	Required	Description
`limit`	No	Maximum order summaries to return (default 5).
`cursor`	No	Opaque nextCursor returned by list_orders.
`detailLimit`	No	Maximum returned summaries to enrich with lines; defaults to limit. Zero skips details.
`includeLines`	No	Read product lines for the returned orders.
Output Schema

TableJSON Schema
Name	Required	Description	Default
`result`	Yes
Schema Changelog

Changes observed during successful MCP inspections.
Changed1 schema field changedv0.6.0Oct 15, 2026
changedOutput schema / properties / result / anyOf
Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "data": {
-        "additionalProperties": false,
-        "properties": {
-          "completeness": {
-            "enum": [
-              "complete",
-              "partial",
-              "unknown"
-            ],
-            "type": "string"
-          },
-          "detailBudget": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "detailsRead": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "failures": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "enum": [
-                    "invalid_data",
-                    "invalid_input",
-                    "not_authenticated",
-                    "upstream_unavailable",
-                    "not_found",
-                    "sale_rules_unknown",
-                    "quantity_below_minimum",
-                    "cart_change_rejected",
-                    "cart_change_unconfirmed",
-                    "cache_unavailable",
-                    "order_details_unavailable",
-                    "cancelled",
-                    "deadline_exceeded",
-                    "server_closed",
-                    "queue_full"
-                  ],
-                  "type": "string"
-                },
-                "issues": {
-                  "items": {
-                    "additionalProperties": false,
-                    "properties": {
-                      "code": {
-                        "type": "string"
-                      },
-                      "path": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "path",
-                      "code"
-                    ],
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "message": {
-                  "minLength": 1,
-                  "type": "string"
-                },
-                "retryable": {
-                  "type": "boolean"
-                }
-              },
-              "required": [
-                "code",
-                "message",
-                "retryable"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "hasMore": {
-            "type": [
-              "boolean",
-              "null"
-            ]
-          },
-          "nextCursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "orders": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "date": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "lines": {
-                  "oneOf": [
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "items": {
-                          "items": {
-                            "additionalProperties": false,
-                            "properties": {
-                              "name": {
-                                "minLength": 1,
-                                "type": "string"
-                              },
-                              "productId": {
-                                "anyOf": [
-                                  {
-                                    "maxLength": 200,
-                                    "minLength": 1,
-                                    "pattern": "^\\d+$",
-                                    "type": "string"
-                                  },
-                                  {
-                                    "type": "null"
-                                  }
-                                ]
-                              },
-                              "quantity": {
-                                "oneOf": [
-                                  {
-                                    "additionalProperties": false,
-                                    "properties": {
-                                      "quantity": {
-                                        "additionalProperties": false,
-                                        "properties": {
-                                          "unit": {
-                                            "enum": [
-                                              "un",
-                                              "kg",
-                                              "g",
-                                              "l",
-                                              "ml"
-                                            ],
-                                            "type": "string"
-                                          },
-                                          "value": {
-                                            "minimum": 0,
-                                            "type": "number"
-                                          }
-                                        },
-                                        "required": [
-                                          "value",
-                                          "unit"
-                                        ],
-                                        "type": "object"
-                                      },
-                                      "status": {
-                                        "const": "known",
-                                        "type": "string"
-                                      }
-                                    },
-                                    "required": [
-                                      "status",
-                                      "quantity"
-                                    ],
-                                    "type": "object"
-                                  },
-                                  {
-                                    "additionalProperties": false,
-                                    "properties": {
-                                      "rawText": {
-                                        "type": [
-                                          "string",
-                                          "null"
-                                        ]
-                                      },
-                                      "reason": {
-                                        "enum": [
-                                          "missing",
-                                          "unsupported_unit",
-                                          "unrecognized_format",
-                                          "invalid_value"
-                                        ],
-                                        "type": "string"
-                                      },
-                                      "status": {
-                                        "const": "unknown",
-                                        "type": "string"
-                                      },
-                                      "value": {
-                                        "anyOf": [
-                                          {
-                                            "minimum": 0,
-                                            "type": "number"
-                                          },
-                                          {
-                                            "type": "null"
-                                          }
-                                        ]
-                                      }
-                                    },
-                                    "required": [
-                                      "status",
-                                      "value",
-                                      "rawText"
-                                    ],
-                                    "type": "object"
-                                  }
-                                ]
-                              }
-                            },
-                            "required": [
-                              "productId",
-                              "name",
-                              "quantity"
-                            ],
-                            "type": "object"
-                          },
-                          "type": "array"
-                        },
-                        "status": {
-                          "const": "available",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "status",
-                        "items"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "error": {
-                          "additionalProperties": false,
-                          "properties": {
-                            "code": {
-                              "enum": [
-                                "invalid_data",
-                                "invalid_input",
-                                "not_authenticated",
-                                "upstream_unavailable",
-                                "not_found",
-                                "sale_rules_unknown",
-                                "quantity_below_minimum",
-                                "cart_change_rejected",
-                                "cart_change_unconfirmed",
-                                "cache_unavailable",
-                                "order_details_unavailable",
-                                "cancelled",
-                                "deadline_exceeded",
-                                "server_closed",
-                                "queue_full"
-                              ],
-                              "type": "string"
-                            },
-                            "issues": {
-                              "items": {
-                                "additionalProperties": false,
-                                "properties": {
-                                  "code": {
-                                    "type": "string"
-                                  },
-                                  "path": {
-                                    "type": "string"
-                                  }
-                                },
-                                "required": [
-                                  "path",
-                                  "code"
-                                ],
-                                "type": "object"
-                              },
-                              "type": "array"
-                            },
-                            "message": {
-                              "minLength": 1,
-                              "type": "string"
-                            },
-                            "retryable": {
-                              "type": "boolean"
-                            }
-                          },
-                          "required": [
-                            "code",
-                            "message",
-                            "retryable"
-                          ],
-                          "type": "object"
-                        },
-                        "status": {
-                          "const": "unavailable",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "status",
-                        "error"
-                      ],
-                      "type": "object"
-                    },
-                    {
-                      "additionalProperties": false,
-                      "properties": {
-                        "status": {
-                          "const": "not_requested",
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "status"
-                      ],
-                      "type": "object"
-                    }
-                  ]
-                },
-                "orderId": {
-                  "anyOf": [
-                    {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "orderNumber": {
-                  "anyOf": [
-                    {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "rawDate": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "orderId",
-                "orderNumber",
-                "date",
-                "lines"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "scanFailures": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "error": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "code": {
-                      "enum": [
-                        "invalid_data",
-                        "invalid_input",
-                        "not_authenticated",
-                        "upstream_unavailable",
-                        "not_found",
-                        "sale_rules_unknown",
-                        "quantity_below_minimum",
-                        "cart_change_rejected",
-                        "cart_change_unconfirmed",
-                        "cache_unavailable",
-                        "order_details_unavailable",
-                        "cancelled",
-                        "deadline_exceeded",
-                        "server_closed",
-                        "queue_full"
-                      ],
-                      "type": "string"
-                    },
-                    "issues": {
-                      "items": {
-                        "additionalProperties": false,
-                        "properties": {
-                          "code": {
-                            "type": "string"
-                          },
-                          "path": {
-                            "type": "string"
-                          }
-                        },
-                        "required": [
-                          "path",
-                          "code"
-                        ],
-                        "type": "object"
-                      },
-                      "type": "array"
-                    },
-                    "message": {
-                      "minLength": 1,
-                      "type": "string"
-                    },
-                    "retryable": {
-                      "type": "boolean"
-                    }
-                  },
-                  "required": [
-                    "code",
-                    "message",
-                    "retryable"
-                  ],
-                  "type": "object"
-                },
-                "orderId": {
-                  "anyOf": [
-                    {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "orderNumber": {
-                  "anyOf": [
-                    {
-                      "maxLength": 200,
-                      "minLength": 1,
-                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "stage": {
-                  "enum": [
-                    "listing",
-                    "detail"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "stage",
-                "orderId",
-                "orderNumber",
-                "error"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "orders",
-          "completeness",
-          "failures",
-          "nextCursor",
-          "hasMore",
-          "detailBudget",
-          "detailsRead",
-          "scanFailures"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "enum": [
-          "success",
-          "empty",
-          "partial"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "data"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "anyOf": [
-              {
-                "enum": [
-                  "invalid_data",
-                  "invalid_input",
-                  "not_authenticated",
-                  "upstream_unavailable",
-                  "not_found",
-                  "sale_rules_unknown",
-                  "quantity_below_minimum",
-                  "cart_change_rejected",
-                  "cart_change_unconfirmed",
-                  "cache_unavailable",
-                  "order_details_unavailable",
-                  "cancelled",
-                  "deadline_exceeded",
-                  "server_closed",
-                  "queue_full"
-                ],
-                "type": "string"
-              },
-              {
-                "enum": [
-                  "internal_error",
-                  "invalid_result"
-                ],
-                "type": "string"
-              }
-            ]
-          },
-          "issues": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "path": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "path",
-                "code"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "message": {
-            "minLength": 1,
-            "type": "string"
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      },
-      "mutation": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "not_applied",
-                "type": "string"
-              }
-            },
-            "required": [
-              "outcome"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "outcome": {
-                "const": "unknown",
-                "type": "string"
-              },
-              "recovery": {
-                "additionalProperties": false,
-                "properties": {
-                  "action": {
-                    "const": "get_cart",
-                    "type": "string"
-                  },
-                  "automaticReplay": {
-                    "const": false,
-                    "type": "boolean"
-                  }
-                },
-                "required": [
-                  "action",
-                  "automaticReplay"
-                ],
-                "type": "object"
-              }
-            },
-            "required": [
-              "outcome",
-              "recovery"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "status": {
-        "const": "error",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "data": {
+        "additionalProperties": false,
+        "properties": {
+          "completeness": {
+            "enum": [
+              "complete",
+              "partial",
+              "unknown"
+            ],
+            "type": "string"
+          },
+          "detailBudget": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "detailsRead": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "failures": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "enum": [
+                    "invalid_data",
+                    "invalid_input",
+                    "not_authenticated",
+                    "upstream_unavailable",
+                    "not_found",
+                    "sale_rules_unknown",
+                    "quantity_below_minimum",
+                    "cart_change_rejected",
+                    "cart_change_unconfirmed",
+                    "cache_unavailable",
+                    "order_details_unavailable",
+                    "cancelled",
+                    "deadline_exceeded",
+                    "server_closed",
+                    "queue_full",
+                    "browser_unavailable"
+                  ],
+                  "type": "string"
+                },
+                "issues": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "code": {
+                        "type": "string"
+                      },
+                      "path": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "path",
+                      "code"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "message": {
+                  "minLength": 1,
+                  "type": "string"
+                },
+                "retryable": {
+                  "type": "boolean"
+                }
+              },
+              "required": [
+                "code",
+                "message",
+                "retryable"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "hasMore": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "nextCursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "orders": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "date": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "lines": {
+                  "oneOf": [
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "items": {
+                          "items": {
+                            "additionalProperties": false,
+                            "properties": {
+                              "name": {
+                                "minLength": 1,
+                                "type": "string"
+                              },
+                              "productId": {
+                                "anyOf": [
+                                  {
+                                    "maxLength": 200,
+                                    "minLength": 1,
+                                    "pattern": "^\\d+$",
+                                    "type": "string"
+                                  },
+                                  {
+                                    "type": "null"
+                                  }
+                                ]
+                              },
+                              "quantity": {
+                                "oneOf": [
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "quantity": {
+                                        "additionalProperties": false,
+                                        "properties": {
+                                          "unit": {
+                                            "enum": [
+                                              "un",
+                                              "kg",
+                                              "g",
+                                              "l",
+                                              "ml"
+                                            ],
+                                            "type": "string"
+                                          },
+                                          "value": {
+                                            "minimum": 0,
+                                            "type": "number"
+                                          }
+                                        },
+                                        "required": [
+                                          "value",
+                                          "unit"
+                                        ],
+                                        "type": "object"
+                                      },
+                                      "status": {
+                                        "const": "known",
+                                        "type": "string"
+                                      }
+                                    },
+                                    "required": [
+                                      "status",
+                                      "quantity"
+                                    ],
+                                    "type": "object"
+                                  },
+                                  {
+                                    "additionalProperties": false,
+                                    "properties": {
+                                      "rawText": {
+                                        "type": [
+                                          "string",
+                                          "null"
+                                        ]
+                                      },
+                                      "reason": {
+                                        "enum": [
+                                          "missing",
+                                          "unsupported_unit",
+                                          "unrecognized_format",
+                                          "invalid_value"
+                                        ],
+                                        "type": "string"
+                                      },
+                                      "status": {
+                                        "const": "unknown",
+                                        "type": "string"
+                                      },
+                                      "value": {
+                                        "anyOf": [
+                                          {
+                                            "minimum": 0,
+                                            "type": "number"
+                                          },
+                                          {
+                                            "type": "null"
+                                          }
+                                        ]
+                                      }
+                                    },
+                                    "required": [
+                                      "status",
+                                      "value",
+                                      "rawText"
+                                    ],
+                                    "type": "object"
+                                  }
+                                ]
+                              }
+                            },
+                            "required": [
+                              "productId",
+                              "name",
+                              "quantity"
+                            ],
+                            "type": "object"
+                          },
+                          "type": "array"
+                        },
+                        "status": {
+                          "const": "available",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "status",
+                        "items"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "error": {
+                          "additionalProperties": false,
+                          "properties": {
+                            "code": {
+                              "enum": [
+                                "invalid_data",
+                                "invalid_input",
+                                "not_authenticated",
+                                "upstream_unavailable",
+                                "not_found",
+                                "sale_rules_unknown",
+                                "quantity_below_minimum",
+                                "cart_change_rejected",
+                                "cart_change_unconfirmed",
+                                "cache_unavailable",
+                                "order_details_unavailable",
+                                "cancelled",
+                                "deadline_exceeded",
+                                "server_closed",
+                                "queue_full",
+                                "browser_unavailable"
+                              ],
+                              "type": "string"
+                            },
+                            "issues": {
+                              "items": {
+                                "additionalProperties": false,
+                                "properties": {
+                                  "code": {
+                                    "type": "string"
+                                  },
+                                  "path": {
+                                    "type": "string"
+                                  }
+                                },
+                                "required": [
+                                  "path",
+                                  "code"
+                                ],
+                                "type": "object"
+                              },
+                              "type": "array"
+                            },
+                            "message": {
+                              "minLength": 1,
+                              "type": "string"
+                            },
+                            "retryable": {
+                              "type": "boolean"
+                            }
+                          },
+                          "required": [
+                            "code",
+                            "message",
+                            "retryable"
+                          ],
+                          "type": "object"
+                        },
+                        "status": {
+                          "const": "unavailable",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "status",
+                        "error"
+                      ],
+                      "type": "object"
+                    },
+                    {
+                      "additionalProperties": false,
+                      "properties": {
+                        "status": {
+                          "const": "not_requested",
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "status"
+                      ],
+                      "type": "object"
+                    }
+                  ]
+                },
+                "orderId": {
+                  "anyOf": [
+                    {
+                      "maxLength": 200,
+                      "minLength": 1,
+                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "orderNumber": {
+                  "anyOf": [
+                    {
+                      "maxLength": 200,
+                      "minLength": 1,
+                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "rawDate": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "orderId",
+                "orderNumber",
+                "date",
+                "lines"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "scanFailures": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "error": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "code": {
+                      "enum": [
+                        "invalid_data",
+                        "invalid_input",
+                        "not_authenticated",
+                        "upstream_unavailable",
+                        "not_found",
+                        "sale_rules_unknown",
+                        "quantity_below_minimum",
+                        "cart_change_rejected",
+                        "cart_change_unconfirmed",
+                        "cache_unavailable",
+                        "order_details_unavailable",
+                        "cancelled",
+                        "deadline_exceeded",
+                        "server_closed",
+                        "queue_full",
+                        "browser_unavailable"
+                      ],
+                      "type": "string"
+                    },
+                    "issues": {
+                      "items": {
+                        "additionalProperties": false,
+                        "properties": {
+                          "code": {
+                            "type": "string"
+                          },
+                          "path": {
+                            "type": "string"
+                          }
+                        },
+                        "required": [
+                          "path",
+                          "code"
+                        ],
+                        "type": "object"
+                      },
+                      "type": "array"
+                    },
+                    "message": {
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "retryable": {
+                      "type": "boolean"
+                    }
+                  },
+                  "required": [
+                    "code",
+                    "message",
+                    "retryable"
+                  ],
+                  "type": "object"
+                },
+                "orderId": {
+                  "anyOf": [
+                    {
+                      "maxLength": 200,
+                      "minLength": 1,
+                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "orderNumber": {
+                  "anyOf": [
+                    {
+                      "maxLength": 200,
+                      "minLength": 1,
+                      "pattern": "^[^\\s\\x00-\\x1f\\x7f]+$",
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ]
+                },
+                "stage": {
+                  "enum": [
+                    "listing",
+                    "detail"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "stage",
+                "orderId",
+                "orderNumber",
+                "error"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "orders",
+          "completeness",
+          "failures",
+          "nextCursor",
+          "hasMore",
+          "detailBudget",
+          "detailsRead",
+          "scanFailures"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "enum": [
+          "success",
+          "empty",
+          "partial"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "data"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "anyOf": [
+              {
+                "enum": [
+                  "invalid_data",
+                  "invalid_input",
+                  "not_authenticated",
+                  "upstream_unavailable",
+                  "not_found",
+                  "sale_rules_unknown",
+                  "quantity_below_minimum",
+                  "cart_change_rejected",
+                  "cart_change_unconfirmed",
+                  "cache_unavailable",
+                  "order_details_unavailable",
+                  "cancelled",
+                  "deadline_exceeded",
+                  "server_closed",
+                  "queue_full",
+                  "browser_unavailable"
+                ],
+                "type": "string"
+              },
+              {
+                "enum": [
+                  "internal_error",
+                  "invalid_result"
+                ],
+                "type": "string"
+              }
+            ]
+          },
+          "issues": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "path": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "path",
+                "code"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "message": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      },
+      "mutation": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "not_applied",
+                "type": "string"
+              }
+            },
+            "required": [
+              "outcome"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "outcome": {
+                "const": "unknown",
+                "type": "string"
+              },
+              "recovery": {
+                "additionalProperties": false,
+                "properties": {
+                  "action": {
+                    "const": "get_cart",
+                    "type": "string"
+                  },
+                  "automaticReplay": {
+                    "const": false,
+                    "type": "boolean"
+                  }
+                },
+                "required": [
+                  "action",
+                  "automaticReplay"
+                ],
+                "type": "object"
+              }
+            },
+            "required": [
+              "outcome",
+              "recovery"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "status": {
+        "const": "error",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "error"
+    ],
+    "type": "object"
+  }
+]
First observedv0.2.0Oct 15, 2026
TDQS

A4.5/5.0
Behavior4/5
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint, so the safety profile is covered. The description adds non-obvious behavior beyond that: results are newest-first, product lines are included by default, and pagination is cursor-based via the returned nextCursor.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Conciseness5/5
Is the description appropriately sized, front-loaded, and free of redundancy?
Three tight sentences: what it returns and in what order first, then sibling routing, then the two knobs for controlling detail and pagination. No filler and nothing buried.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Completeness5/5
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
An output schema exists so return shapes need not be documented, and the description still covers the parts an agent must know to call it correctly: default line inclusion, detail reduction options, and cursor-based continuation. Nothing material is missing.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Parameters4/5
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 100%, so the baseline is 3, but the description adds genuine value by explaining the interplay between detailLimit and includeLines: false and by spelling out the cursor round-trip (returned nextCursor -> cursor), which the schema descriptions only state in isolation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Purpose5/5
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource plus ordering semantics ('List recent orders, newest first, with their product lines') and explicitly cross-references the sibling get_order, so an agent can distinguish this list tool from the single-order tool without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Usage Guidelines4/5
Does the description explain when to use this tool, when not to, or what alternatives exist?
It gives concrete routing guidance: use get_order for an individual order, use detailLimit or includeLines: false when fewer details are wanted, and pass nextCursor as cursor to continue. It stops short of an explicit 'do not use this when...' clause, but the alternative and the conditions are clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Deploy Server