Skip to main content
Glama

Get order

get_order
Read-onlyIdempotent

Retrieve the product lines of a specific order using its internal orderId from list_orders. Use it to inspect order contents by ID, not the displayed order number.

Instructions

Get the product lines of one order by its orderId from list_orders (not the displayed order number).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
orderIdYesInternal orderId from list_orders; distinct from the displayed order number.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changedv0.6.0
    • changedOutput schema / properties / result / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "data": {
      -        "additionalProperties": false,
      -        "properties": {
      -          "order": {
      -            "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"
      -          },
      -          "unknownQuantityLines": {
      -            "maximum": 9007199254740991,
      -            "minimum": 0,
      -            "type": "integer"
      -          }
      -        },
      -        "required": [
      -          "order",
      -          "unknownQuantityLines"
      -        ],
      -        "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": {
      +          "order": {
      +            "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"
      +          },
      +          "unknownQuantityLines": {
      +            "maximum": 9007199254740991,
      +            "minimum": 0,
      +            "type": "integer"
      +          }
      +        },
      +        "required": [
      +          "order",
      +          "unknownQuantityLines"
      +        ],
      +        "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"
      +  }
      +]
  2. First observedv0.2.0

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive, openWorld, so the safety profile is covered structurally. The description adds only the identifier-source constraint and the fact that product lines are returned; it says nothing about missing-order behavior, but the output schema covers return shape.

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?

One tight sentence with the resource front-loaded and the parenthetical clarification placed exactly where it prevents the likely mistake. No filler, nothing that could be cut.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With annotations, a fully described single parameter, and an output schema present, an agent has everything needed to call this correctly. Only error/empty-result behavior for an unknown orderId is unaddressed, which is minor given the output schema.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the single parameter already documents that orderId is the internal id from list_orders, distinct from the displayed number. The description restates this rather than adding format, pattern, or lookup semantics beyond the schema. Baseline 3 applies.

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?

States a specific verb ('Get') and resource ('the product lines of one order'), and names the sibling list_orders as the source of the identifier. An agent can tell this apart from list_orders 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?

Gives a clear prerequisite for invoking it: the orderId must come from list_orders and is explicitly not the displayed order number. It doesn't name a when-not or an alternative detail-fetching path, but there is no competing sibling for order lines, so the guidance is sufficient context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.