Skip to main content
Glama

SendaMeal Storefront

search_products

Search products by a term

Arguments: term - the search term to look for products. It should be at least 3 characters long. cursor - optional, used for pagination. If provided, it will return the next page of results after.

Pagination: Supports pagination with 'cursor' arguments. If 'cursor' is not provided, it will return the first page of results. Value for 'cursor' can be obtained from the 'nextCursor' field in the response. If 'nextCursor' is null, it means there are no more results to fetch. If value of cursor is null (or a string representation of 'null') dont send it in the payload.

Results: Each product includes 'requiresFileUpload'. When true, the product has a required file-upload option (e.g. "upload your design") and shouldn't be added to cart through this assistant. Do not attempt to purchase it — tell the user it must be ordered on the website.

Stock: Each product carries 'inStock'. It reports whether the store has units on hand. It does NOT report whether the item can be bought.

  • false does NOT mean the purchase will fail. Many stores accept orders for out-of-stock items - backorder, pre-order, or made-to-order goods that are fabricated after ordering. Whether a given store does is not exposed by this API. So: tell the user the item is out of stock and may take longer to arrive, then ADD IT if they still want it. Do not refuse on 'inStock: false' alone.

  • If the store really does block it, 'add_item_to_cart' fails and returns the reason. Relay that reason to the user. Attempting the add is the only reliable way to find out.

  • true only means no out-of-stock condition is reported. A store that does not track inventory reports true for every product, so never state or imply a quantity.

  • 'inventoryLevel' appears only on stores that publish stock figures; absent means undisclosed, not zero.

Flow:

  • Call this tool with a 'term' argument and optionally with 'cursor' to search for products.

    • if you find a matching product, call 'get_product_details' with the product ID to get its variants and options (if any).

    • if 'requiresFileUpload' is true, inform the user the product needs a file upload and cannot be purchased here.

  • Call 'add_item_to_cart' with results of 'search_products' and 'get_product_details' (variant) tools to add the product to the cart.

    • [IMPORTANT] If product has variants ask user to pick

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
termYes
cursorNo
contextNoAdditional information about the request such as user demographics, mood, location, or other relevant details that could help in tailoring the response appropriately. Should not contains PII.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
messageNo
successYes
productsYes
nextCursorNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / products / items / properties / inStock
      Added value: +{
      +  "type": [
      +    "null",
      +    "boolean"
      +  ]
      +}
  2. Changed20 schema fields changed
    • addedOutput schema / properties / products / items / properties / availability
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / currencyCode
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / products / items / properties / description
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / entityId
      Removed value: -{
      -  "type": "integer"
      -}
    • addedOutput schema / properties / products / items / properties / hasBulkPricing
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / id
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / products / items / properties / imageUrl
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / inventoryLevel
      Added value: +{
      +  "type": [
      +    "null",
      +    "integer"
      +  ]
      +}
    • addedOutput schema / properties / products / items / properties / inventoryTracking
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / isPriceHidden
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / orderQuantityMaximum
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / products / items / properties / orderQuantityMinimum
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / properties / products / items / properties / price
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / products / items / properties / priceRange
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "max": {
      +      "type": "number"
      +    },
      +    "min": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "min",
      +    "max"
      +  ],
      +  "type": [
      +    "null",
      +    "object"
      +  ]
      +}
    • removedOutput schema / properties / products / items / properties / productOptions
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "checkedOptionValueEntityId": {
      -                "type": "integer"
      -              },
      -              "label": {
      -                "type": "string"
      -              },
      -              "uncheckedOptionValueEntityId": {
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "label",
      -              "checkedOptionValueEntityId",
      -              "uncheckedOptionValueEntityId"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "defaultValue": {
      -                "type": "string"
      -              },
      -              "earliest": {
      -                "type": "string"
      -              },
      -              "latest": {
      -                "type": "string"
      -              },
      -              "limitDateBy": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "defaultValue",
      -              "earliest",
      -              "latest",
      -              "limitDateBy"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "fileTypes": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": [
      -                  "null",
      -                  "array"
      -                ]
      -              },
      -              "maxFileSize": {
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "maxFileSize",
      -              "fileTypes"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "maxLength": {
      -                "type": "integer"
      -              },
      -              "maxLines": {
      -                "type": "integer"
      -              },
      -              "minLength": {
      -                "type": "integer"
      -              },
      -              "multilineDefaultValue": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "multilineDefaultValue",
      -              "minLength",
      -              "maxLength",
      -              "maxLines"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "highest": {
      -                "type": "number"
      -              },
      -              "isIntegerOnly": {
      -                "type": "boolean"
      -              },
      -              "limitNumberBy": {
      -                "type": "string"
      -              },
      -              "lowest": {
      -                "type": "number"
      -              },
      -              "numberDefaultValue": {
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "numberDefaultValue",
      -              "lowest",
      -              "highest",
      -              "isIntegerOnly",
      -              "limitNumberBy"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "maxLength": {
      -                "type": "integer"
      -              },
      -              "minLength": {
      -                "type": "integer"
      -              },
      -              "textDefaultValue": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "textDefaultValue",
      -              "minLength",
      -              "maxLength"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "entityId": {
      -                  "type": "integer"
      -                },
      -                "hexColors": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": [
      -                    "null",
      -                    "array"
      -                  ]
      -                },
      -                "isDefault": {
      -                  "type": "boolean"
      -                },
      -                "isSelected": {
      -                  "type": "boolean"
      -                },
      -                "label": {
      -                  "type": "string"
      -                },
      -                "productId": {
      -                  "type": [
      -                    "null",
      -                    "integer"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "entityId",
      -                "label",
      -                "isDefault",
      -                "isSelected"
      -              ],
      -              "type": "object"
      -            },
      -            "type": [
      -              "null",
      -              "array"
      -            ]
      -          }
      -        ]
      -      },
      -      "displayName": {
      -        "type": "string"
      -      },
      -      "entityId": {
      -        "type": "integer"
      -      },
      -      "isVariantOption": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "entityId",
      -      "displayName",
      -      "isVariantOption"
      -    ],
      -    "type": "object"
      -  },
      -  "type": [
      -    "null",
      -    "array"
      -  ]
      -}
    • addedOutput schema / properties / products / items / properties / productUrl
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / requiresFileUpload
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / sku
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / variantCount
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / properties / products / items / required
      Previous value: -[
      -  "entityId",
      -  "name",
      -  "description",
      -  "price"
      -]New value: +[
      +  "id",
      +  "name",
      +  "sku",
      +  "hasBulkPricing",
      +  "isPriceHidden"
      +]
  3. Changed20 schema fields changed
    • removedOutput schema / properties / products / items / properties / availability
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / currencyCode
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / products / items / properties / description
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / entityId
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / properties / products / items / properties / hasBulkPricing
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / products / items / properties / id
      Removed value: -{
      -  "type": "integer"
      -}
    • removedOutput schema / properties / products / items / properties / imageUrl
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / inventoryLevel
      Removed value: -{
      -  "type": [
      -    "null",
      -    "integer"
      -  ]
      -}
    • removedOutput schema / properties / products / items / properties / inventoryTracking
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / isPriceHidden
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / products / items / properties / orderQuantityMaximum
      Removed value: -{
      -  "type": "integer"
      -}
    • removedOutput schema / properties / products / items / properties / orderQuantityMinimum
      Removed value: -{
      -  "type": "integer"
      -}
    • addedOutput schema / properties / products / items / properties / price
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / products / items / properties / priceRange
      Removed value: -{
      -  "additionalProperties": false,
      -  "properties": {
      -    "max": {
      -      "type": "number"
      -    },
      -    "min": {
      -      "type": "number"
      -    }
      -  },
      -  "required": [
      -    "min",
      -    "max"
      -  ],
      -  "type": [
      -    "null",
      -    "object"
      -  ]
      -}
    • addedOutput schema / properties / products / items / properties / productOptions
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "details": {
      +        "oneOf": [
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "checkedOptionValueEntityId": {
      +                "type": "integer"
      +              },
      +              "label": {
      +                "type": "string"
      +              },
      +              "uncheckedOptionValueEntityId": {
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "label",
      +              "checkedOptionValueEntityId",
      +              "uncheckedOptionValueEntityId"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "defaultValue": {
      +                "type": "string"
      +              },
      +              "earliest": {
      +                "type": "string"
      +              },
      +              "latest": {
      +                "type": "string"
      +              },
      +              "limitDateBy": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "defaultValue",
      +              "earliest",
      +              "latest",
      +              "limitDateBy"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "fileTypes": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": [
      +                  "null",
      +                  "array"
      +                ]
      +              },
      +              "maxFileSize": {
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "maxFileSize",
      +              "fileTypes"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "maxLength": {
      +                "type": "integer"
      +              },
      +              "maxLines": {
      +                "type": "integer"
      +              },
      +              "minLength": {
      +                "type": "integer"
      +              },
      +              "multilineDefaultValue": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "multilineDefaultValue",
      +              "minLength",
      +              "maxLength",
      +              "maxLines"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "highest": {
      +                "type": "number"
      +              },
      +              "isIntegerOnly": {
      +                "type": "boolean"
      +              },
      +              "limitNumberBy": {
      +                "type": "string"
      +              },
      +              "lowest": {
      +                "type": "number"
      +              },
      +              "numberDefaultValue": {
      +                "type": "number"
      +              }
      +            },
      +            "required": [
      +              "numberDefaultValue",
      +              "lowest",
      +              "highest",
      +              "isIntegerOnly",
      +              "limitNumberBy"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "additionalProperties": false,
      +            "properties": {
      +              "maxLength": {
      +                "type": "integer"
      +              },
      +              "minLength": {
      +                "type": "integer"
      +              },
      +              "textDefaultValue": {
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "textDefaultValue",
      +              "minLength",
      +              "maxLength"
      +            ],
      +            "type": "object"
      +          },
      +          {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "entityId": {
      +                  "type": "integer"
      +                },
      +                "hexColors": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": [
      +                    "null",
      +                    "array"
      +                  ]
      +                },
      +                "isDefault": {
      +                  "type": "boolean"
      +                },
      +                "isSelected": {
      +                  "type": "boolean"
      +                },
      +                "label": {
      +                  "type": "string"
      +                },
      +                "productId": {
      +                  "type": [
      +                    "null",
      +                    "integer"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "entityId",
      +                "label",
      +                "isDefault",
      +                "isSelected"
      +              ],
      +              "type": "object"
      +            },
      +            "type": [
      +              "null",
      +              "array"
      +            ]
      +          }
      +        ]
      +      },
      +      "displayName": {
      +        "type": "string"
      +      },
      +      "entityId": {
      +        "type": "integer"
      +      },
      +      "isVariantOption": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "entityId",
      +      "displayName",
      +      "isVariantOption"
      +    ],
      +    "type": "object"
      +  },
      +  "type": [
      +    "null",
      +    "array"
      +  ]
      +}
    • removedOutput schema / properties / products / items / properties / productUrl
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / requiresFileUpload
      Removed value: -{
      -  "type": "boolean"
      -}
    • removedOutput schema / properties / products / items / properties / sku
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / variantCount
      Removed value: -{
      -  "type": "integer"
      -}
    • changedOutput schema / properties / products / items / required
      Previous value: -[
      -  "id",
      -  "name",
      -  "sku",
      -  "hasBulkPricing",
      -  "isPriceHidden"
      -]New value: +[
      +  "entityId",
      +  "name",
      +  "description",
      +  "price"
      +]
  4. Changed20 schema fields changed
    • addedOutput schema / properties / products / items / properties / availability
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / currencyCode
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / products / items / properties / description
      Removed value: -{
      -  "type": "string"
      -}
    • removedOutput schema / properties / products / items / properties / entityId
      Removed value: -{
      -  "type": "integer"
      -}
    • addedOutput schema / properties / products / items / properties / hasBulkPricing
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / id
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / products / items / properties / imageUrl
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / inventoryLevel
      Added value: +{
      +  "type": [
      +    "null",
      +    "integer"
      +  ]
      +}
    • addedOutput schema / properties / products / items / properties / inventoryTracking
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / isPriceHidden
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / orderQuantityMaximum
      Added value: +{
      +  "type": "integer"
      +}
    • addedOutput schema / properties / products / items / properties / orderQuantityMinimum
      Added value: +{
      +  "type": "integer"
      +}
    • removedOutput schema / properties / products / items / properties / price
      Removed value: -{
      -  "type": "string"
      -}
    • addedOutput schema / properties / products / items / properties / priceRange
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "max": {
      +      "type": "number"
      +    },
      +    "min": {
      +      "type": "number"
      +    }
      +  },
      +  "required": [
      +    "min",
      +    "max"
      +  ],
      +  "type": [
      +    "null",
      +    "object"
      +  ]
      +}
    • removedOutput schema / properties / products / items / properties / productOptions
      Removed value: -{
      -  "items": {
      -    "additionalProperties": false,
      -    "properties": {
      -      "details": {
      -        "oneOf": [
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "checkedOptionValueEntityId": {
      -                "type": "integer"
      -              },
      -              "label": {
      -                "type": "string"
      -              },
      -              "uncheckedOptionValueEntityId": {
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "label",
      -              "checkedOptionValueEntityId",
      -              "uncheckedOptionValueEntityId"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "defaultValue": {
      -                "type": "string"
      -              },
      -              "earliest": {
      -                "type": "string"
      -              },
      -              "latest": {
      -                "type": "string"
      -              },
      -              "limitDateBy": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "defaultValue",
      -              "earliest",
      -              "latest",
      -              "limitDateBy"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "fileTypes": {
      -                "items": {
      -                  "type": "string"
      -                },
      -                "type": [
      -                  "null",
      -                  "array"
      -                ]
      -              },
      -              "maxFileSize": {
      -                "type": "integer"
      -              }
      -            },
      -            "required": [
      -              "maxFileSize",
      -              "fileTypes"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "maxLength": {
      -                "type": "integer"
      -              },
      -              "maxLines": {
      -                "type": "integer"
      -              },
      -              "minLength": {
      -                "type": "integer"
      -              },
      -              "multilineDefaultValue": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "multilineDefaultValue",
      -              "minLength",
      -              "maxLength",
      -              "maxLines"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "highest": {
      -                "type": "number"
      -              },
      -              "isIntegerOnly": {
      -                "type": "boolean"
      -              },
      -              "limitNumberBy": {
      -                "type": "string"
      -              },
      -              "lowest": {
      -                "type": "number"
      -              },
      -              "numberDefaultValue": {
      -                "type": "number"
      -              }
      -            },
      -            "required": [
      -              "numberDefaultValue",
      -              "lowest",
      -              "highest",
      -              "isIntegerOnly",
      -              "limitNumberBy"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "additionalProperties": false,
      -            "properties": {
      -              "maxLength": {
      -                "type": "integer"
      -              },
      -              "minLength": {
      -                "type": "integer"
      -              },
      -              "textDefaultValue": {
      -                "type": "string"
      -              }
      -            },
      -            "required": [
      -              "textDefaultValue",
      -              "minLength",
      -              "maxLength"
      -            ],
      -            "type": "object"
      -          },
      -          {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "entityId": {
      -                  "type": "integer"
      -                },
      -                "hexColors": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": [
      -                    "null",
      -                    "array"
      -                  ]
      -                },
      -                "isDefault": {
      -                  "type": "boolean"
      -                },
      -                "isSelected": {
      -                  "type": "boolean"
      -                },
      -                "label": {
      -                  "type": "string"
      -                },
      -                "productId": {
      -                  "type": [
      -                    "null",
      -                    "integer"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "entityId",
      -                "label",
      -                "isDefault",
      -                "isSelected"
      -              ],
      -              "type": "object"
      -            },
      -            "type": [
      -              "null",
      -              "array"
      -            ]
      -          }
      -        ]
      -      },
      -      "displayName": {
      -        "type": "string"
      -      },
      -      "entityId": {
      -        "type": "integer"
      -      },
      -      "isVariantOption": {
      -        "type": "boolean"
      -      }
      -    },
      -    "required": [
      -      "entityId",
      -      "displayName",
      -      "isVariantOption"
      -    ],
      -    "type": "object"
      -  },
      -  "type": [
      -    "null",
      -    "array"
      -  ]
      -}
    • addedOutput schema / properties / products / items / properties / productUrl
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / requiresFileUpload
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / products / items / properties / sku
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / products / items / properties / variantCount
      Added value: +{
      +  "type": "integer"
      +}
    • changedOutput schema / properties / products / items / required
      Previous value: -[
      -  "entityId",
      -  "name",
      -  "description",
      -  "price"
      -]New value: +[
      +  "id",
      +  "name",
      +  "sku",
      +  "hasBulkPricing",
      +  "isPriceHidden"
      +]
  5. First observed

TDQS

A4.9/5.0
Behavior5/5

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

No annotations are provided, so the description carries the full burden. It thoroughly discloses behavior: pagination semantics, the meaning of requiresFileUpload, inStock and inventoryLevel caveats, and the recommended handling of out-of-stock items. It also explains that inStock false does not guarantee purchase failure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is longer than average but well-structured with headings. It includes necessary edge-case explanations and flow guidance. There is minor redundancy around cursor null handling, but overall each section contributes value.

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?

The description covers not only how to invoke the tool but also how to interpret results, handle file-upload products, deal with stock status nuances, and proceed with cart operations. It is comprehensive enough for an agent to use the tool correctly without additional context.

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

Parameters5/5

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

The schema only describes 'context', but the description adds meaningful detail for 'term' (minimum length) and 'cursor' (pagination usage and source from nextCursor). All parameters are effectively covered when combining schema and description.

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 clearly states the tool's purpose with a specific verb and resource: 'Search products by a term'. It is easily distinguished from sibling tools like get_product_details, add_item_to_cart, and checkout-related tools.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit usage instructions, including when to call this tool, how to supply 'term' and optional 'cursor', and the subsequent flow involving get_product_details and add_item_to_cart. It also clarifies when not to proceed, such as when requiresFileUpload is true.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources