Skip to main content
Glama

Get product

get_product
Read-onlyIdempotent

Retrieve a product's price, availability, and sale rules by product ID, including unit, min, max, and step. Check before choosing quantities for weighted or bulk items; no login needed.

Instructions

Get one product by productId: price, availability and sale rules (sale unit, minimum, maximum and step). Check this before choosing a quantity for weighted or bulk products. No login needed.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
productIdYesproductId from another tool, such as "00123". A product slug ending in that ID (for example "leite-00123") also works.

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": {
      -          "availability": {
      -            "enum": [
      -              "available",
      -              "unavailable",
      -              "unknown"
      -            ],
      -            "type": "string"
      -          },
      -          "name": {
      -            "maxLength": 250,
      -            "minLength": 1,
      -            "type": "string"
      -          },
      -          "price": {
      -            "additionalProperties": false,
      -            "properties": {
      -              "amount": {
      -                "anyOf": [
      -                  {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "currency": {
      -                        "const": "EUR",
      -                        "type": "string"
      -                      },
      -                      "minorUnits": {
      -                        "maximum": 9007199254740991,
      -                        "minimum": 0,
      -                        "type": "integer"
      -                      }
      -                    },
      -                    "required": [
      -                      "currency",
      -                      "minorUnits"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  {
      -                    "type": "null"
      -                  }
      -                ]
      -              },
      -              "basis": {
      -                "enum": [
      -                  "unit",
      -                  "line",
      -                  "unknown"
      -                ],
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "amount",
      -              "basis"
      -            ],
      -            "type": "object"
      -          },
      -          "productId": {
      -            "maxLength": 200,
      -            "minLength": 1,
      -            "pattern": "^\\d+$",
      -            "type": "string"
      -          },
      -          "productSlug": {
      -            "anyOf": [
      -              {
      -                "maxLength": 200,
      -                "type": "string"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "saleRules": {
      -            "oneOf": [
      -              {
      -                "additionalProperties": false,
      -                "properties": {
      -                  "rules": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "maximum": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "unit": {
      -                                "enum": [
      -                                  "un",
      -                                  "kg",
      -                                  "g",
      -                                  "l",
      -                                  "ml"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "minimum": 0,
      -                                "type": "number"
      -                              }
      -                            },
      -                            "required": [
      -                              "value",
      -                              "unit"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "minimum": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "unit": {
      -                                "enum": [
      -                                  "un",
      -                                  "kg",
      -                                  "g",
      -                                  "l",
      -                                  "ml"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "minimum": 0,
      -                                "type": "number"
      -                              }
      -                            },
      -                            "required": [
      -                              "value",
      -                              "unit"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "saleUnit": {
      -                        "enum": [
      -                          "un",
      -                          "kg",
      -                          "g",
      -                          "l",
      -                          "ml"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "step": {
      -                        "anyOf": [
      -                          {
      -                            "additionalProperties": false,
      -                            "properties": {
      -                              "unit": {
      -                                "enum": [
      -                                  "un",
      -                                  "kg",
      -                                  "g",
      -                                  "l",
      -                                  "ml"
      -                                ],
      -                                "type": "string"
      -                              },
      -                              "value": {
      -                                "minimum": 0,
      -                                "type": "number"
      -                              }
      -                            },
      -                            "required": [
      -                              "value",
      -                              "unit"
      -                            ],
      -                            "type": "object"
      -                          },
      -                          {
      -                            "type": "null"
      -                          }
      -                        ]
      -                      },
      -                      "storefrontUnit": {
      -                        "enum": [
      -                          "un",
      -                          "kg",
      -                          "g",
      -                          "l",
      -                          "ml"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "storefrontUnitsPerSaleUnit": {
      -                        "exclusiveMinimum": 0,
      -                        "type": "number"
      -                      }
      -                    },
      -                    "required": [
      -                      "saleUnit",
      -                      "storefrontUnit",
      -                      "storefrontUnitsPerSaleUnit",
      -                      "minimum",
      -                      "maximum",
      -                      "step"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "status": {
      -                    "const": "available",
      -                    "type": "string"
      -                  }
      -                },
      -                "required": [
      -                  "status",
      -                  "rules"
      -                ],
      -                "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"
      -              }
      -            ]
      -          },
      -          "unitPriceText": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "url": {
      -            "format": "uri",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "productId",
      -          "productSlug",
      -          "name",
      -          "url",
      -          "price",
      -          "unitPriceText",
      -          "availability",
      -          "saleRules"
      -        ],
      -        "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": {
      +          "availability": {
      +            "enum": [
      +              "available",
      +              "unavailable",
      +              "unknown"
      +            ],
      +            "type": "string"
      +          },
      +          "name": {
      +            "maxLength": 250,
      +            "minLength": 1,
      +            "type": "string"
      +          },
      +          "price": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "amount": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "currency": {
      +                        "const": "EUR",
      +                        "type": "string"
      +                      },
      +                      "minorUnits": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      }
      +                    },
      +                    "required": [
      +                      "currency",
      +                      "minorUnits"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "per": {
      +                    "enum": [
      +                      "item",
      +                      "piece",
      +                      "kg",
      +                      "l"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "amount",
      +                  "per"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "productId": {
      +            "maxLength": 200,
      +            "minLength": 1,
      +            "pattern": "^\\d+$",
      +            "type": "string"
      +          },
      +          "productSlug": {
      +            "anyOf": [
      +              {
      +                "maxLength": 200,
      +                "type": "string"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "recommendedPrice": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "amount": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "currency": {
      +                        "const": "EUR",
      +                        "type": "string"
      +                      },
      +                      "minorUnits": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      }
      +                    },
      +                    "required": [
      +                      "currency",
      +                      "minorUnits"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "per": {
      +                    "enum": [
      +                      "item",
      +                      "piece",
      +                      "kg",
      +                      "l"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "amount",
      +                  "per"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "saleRules": {
      +            "oneOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "rules": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "maximum": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "unit": {
      +                                "enum": [
      +                                  "un",
      +                                  "kg",
      +                                  "g",
      +                                  "l",
      +                                  "ml"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "value": {
      +                                "minimum": 0,
      +                                "type": "number"
      +                              }
      +                            },
      +                            "required": [
      +                              "value",
      +                              "unit"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "minimum": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "unit": {
      +                                "enum": [
      +                                  "un",
      +                                  "kg",
      +                                  "g",
      +                                  "l",
      +                                  "ml"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "value": {
      +                                "minimum": 0,
      +                                "type": "number"
      +                              }
      +                            },
      +                            "required": [
      +                              "value",
      +                              "unit"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "saleUnit": {
      +                        "enum": [
      +                          "un",
      +                          "kg",
      +                          "g",
      +                          "l",
      +                          "ml"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "step": {
      +                        "anyOf": [
      +                          {
      +                            "additionalProperties": false,
      +                            "properties": {
      +                              "unit": {
      +                                "enum": [
      +                                  "un",
      +                                  "kg",
      +                                  "g",
      +                                  "l",
      +                                  "ml"
      +                                ],
      +                                "type": "string"
      +                              },
      +                              "value": {
      +                                "minimum": 0,
      +                                "type": "number"
      +                              }
      +                            },
      +                            "required": [
      +                              "value",
      +                              "unit"
      +                            ],
      +                            "type": "object"
      +                          },
      +                          {
      +                            "type": "null"
      +                          }
      +                        ]
      +                      },
      +                      "storefrontUnit": {
      +                        "enum": [
      +                          "un",
      +                          "kg",
      +                          "g",
      +                          "l",
      +                          "ml"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "storefrontUnitsPerSaleUnit": {
      +                        "exclusiveMinimum": 0,
      +                        "type": "number"
      +                      }
      +                    },
      +                    "required": [
      +                      "saleUnit",
      +                      "storefrontUnit",
      +                      "storefrontUnitsPerSaleUnit",
      +                      "minimum",
      +                      "maximum",
      +                      "step"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "status": {
      +                    "const": "available",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "status",
      +                  "rules"
      +                ],
      +                "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"
      +              }
      +            ]
      +          },
      +          "secondaryPrice": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "amount": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "currency": {
      +                        "const": "EUR",
      +                        "type": "string"
      +                      },
      +                      "minorUnits": {
      +                        "maximum": 9007199254740991,
      +                        "minimum": 0,
      +                        "type": "integer"
      +                      }
      +                    },
      +                    "required": [
      +                      "currency",
      +                      "minorUnits"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "per": {
      +                    "enum": [
      +                      "item",
      +                      "piece",
      +                      "kg",
      +                      "l"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "amount",
      +                  "per"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "url": {
      +            "format": "uri",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "productId",
      +          "productSlug",
      +          "name",
      +          "url",
      +          "price",
      +          "secondaryPrice",
      +          "recommendedPrice",
      +          "availability",
      +          "saleRules"
      +        ],
      +        "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.3/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, openWorld, non-destructive. The description adds genuinely new context beyond them: no authentication is required, and the response carries sale rules (sale unit, minimum, maximum, step) that matter behaviorally for quantity selection. It stops short of describing failure modes for an invalid id.

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 short sentences, zero filler, front-loaded with the identity of the tool before the use-case hint and the auth note. Every sentence earns its place.

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 values need no exposition, and the single required parameter is fully documented in the schema. Between the description, annotations, and schema, an agent has everything needed to call this correctly.

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 schema itself explains the productId format, slug suffix tolerance, and pattern. The description adds nothing about the parameter beyond 'by productId', so the 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 and resource ('Get one product by productId') and enumerates the payload (price, availability, sale rules), which separates it from the listing sibling search_products. An agent knows immediately this is a single-item lookup, not a search.

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 clear situational context: check this before choosing a quantity for weighted or bulk products. That is a real use condition, but the description never names an alternative tool (e.g., search_products) or a when-not-to-use case, so it stops short of full routing guidance.

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