Skip to main content
Glama
Sign In

Tallybuy

by com.tallybuy
OverviewDiscussionsAdmin

Search products

search_products
Read-onlyIdempotent

Find products in a market by words or by an exact identifier (GTIN or model number). Every word must match the name, brand or category; a word of four or more letters matches as a prefix, so OLED55 finds OLED55C54LA; ä, ö, ü, ß may be written ae, oe, ue, ss; a size unit after a number (55 Zoll, 55 inch) is ignored. On zero results, search again with fewer or broader words. Each result has product_url, its Tallybuy page comparing every offer, and its lowest delivered total and lowest item price; each quote names the seller, observed_at, currency, currency_exponent and purchase_url. Cite the seller and observed_at with every price. Null is unknown, never zero. purchase_url is a Tallybuy link; Tallybuy may earn a commission when someone buys, at no extra cost to them. Say so when you give the link. Results are candidates, not recommendations, and may include accessories. market_id, locale, currency and destination_country are required: take them from list_markets. Use list_offers instead when you need every seller of one variant; use list_price_drops instead when the person asks what is priced lower than usual.

Input Schema

NameRequiredDescriptionDefault
qYesDeterministic text or exact identifier query
limitNoDefault 10; maximum 50
cursorNoOpaque service cursor from the previous page
localeYesRequired: the market default_locale from list_markets
brand_idNo
currencyYesRequired: the market default_currency from list_markets
market_idYesRequired: active destination market UUID from list_markets
destination_countryYesRequired: the market country_code from list_markets

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / anyOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "attribute_facets": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "buckets": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "count": {
-                    "type": "integer"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "selected": {
-                    "type": "boolean"
-                  },
-                  "value": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "value",
-                  "name",
-                  "count",
-                  "selected"
-                ],
-                "type": "object"
-              },
-              "type": [
-                "null",
-                "array"
-              ]
-            },
-            "conflict_count": {
-              "type": "integer"
-            },
-            "has_more_values": {
-              "type": "boolean"
-            },
-            "key": {
-              "type": "string"
-            },
-            "known_count": {
-              "type": "integer"
-            },
-            "known_max": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "known_min": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "not_applicable_count": {
-              "type": "integer"
-            },
-            "unknown_count": {
-              "type": "integer"
-            },
-            "value_type": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "value_type",
-            "known_count",
-            "conflict_count",
-            "unknown_count",
-            "not_applicable_count",
-            "known_min",
-            "known_max",
-            "buckets",
-            "has_more_values"
-          ],
-          "type": "object"
-        },
-        "type": [
-          "null",
-          "array"
-        ]
-      },
-      "attribution": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "text": {
-              "type": "string"
-            },
-            "url": {
-              "type": [
-                "null",
-                "string"
-              ]
-            }
-          },
-          "required": [
-            "text",
-            "url"
-          ],
-          "type": "object"
-        },
-        "type": [
-          "null",
-          "array"
-        ]
-      },
-      "catalog_scope": {
-        "type": "string"
-      },
-      "category_id": {
-        "type": "string"
-      },
-      "context": {
-        "additionalProperties": false,
-        "properties": {
-          "audience": {
-            "type": "string"
-          },
-          "context_key": {
-            "type": "string"
-          },
-          "currency": {
-            "type": "string"
-          },
-          "currency_exponent": {
-            "type": "integer"
-          },
-          "destination_country": {
-            "type": "string"
-          },
-          "filters": {
-            "additionalProperties": false,
-            "properties": {
-              "availability": {
-                "type": "string"
-              },
-              "condition": {
-                "type": "string"
-              },
-              "merchant_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "condition",
-              "availability",
-              "merchant_id"
-            ],
-            "type": "object"
-          },
-          "market_id": {
-            "type": "string"
-          },
-          "quantity": {
-            "type": "string"
-          },
-          "quantity_unit": {
-            "type": "string"
-          },
-          "sort": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "market_id",
-          "currency",
-          "currency_exponent",
-          "destination_country",
-          "context_key",
-          "quantity",
-          "quantity_unit",
-          "audience",
-          "sort",
-          "filters"
-        ],
-        "type": "object"
-      },
-      "count_capped": {
-        "type": "boolean"
-      },
-      "count_relation": {
-        "type": "string"
-      },
-      "effective_filters": {
-        "additionalProperties": false,
-        "properties": {
-          "attributes": {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "boolean_value": {
-                  "type": [
-                    "null",
-                    "boolean"
-                  ]
-                },
-                "include_unknown": {
-                  "type": "boolean"
-                },
-                "key": {
-                  "type": "string"
-                },
-                "max": {
-                  "type": [
-                    "null",
-                    "string"
-                  ]
-                },
-                "min": {
-                  "type": [
-                    "null",
-                    "string"
-                  ]
-                },
-                "operator": {
-                  "type": "string"
-                },
-                "option_ids": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": [
-                    "null",
-                    "array"
-                  ]
-                }
-              },
-              "required": [
-                "key",
-                "operator",
-                "min",
-                "max",
-                "option_ids",
-                "boolean_value",
-                "include_unknown"
-              ],
-              "type": "object"
-            },
-            "type": [
-              "null",
-              "array"
-            ]
-          },
-          "availability": {
-            "items": {
-              "type": "string"
-            },
-            "type": [
-              "null",
-              "array"
-            ]
-          },
-          "brand_ids": {
-            "items": {
-              "type": "string"
-            },
-            "type": [
-              "null",
-              "array"
-            ]
-          },
-          "merchant_ids": {
-            "items": {
-              "type": "string"
-            },
-            "type": [
-              "null",
-              "array"
-            ]
-          },
-          "price": {
-            "additionalProperties": false,
-            "properties": {
-              "basis": {
-                "type": "string"
-              },
-              "include_unknown": {
-                "type": "boolean"
-              },
-              "max_minor": {
-                "type": [
-                  "null",
-                  "string"
-                ]
-              },
-              "min_minor": {
-                "type": [
-                  "null",
-                  "string"
-                ]
-              }
-            },
-            "required": [
-              "basis",
-              "min_minor",
-              "max_minor",
-              "include_unknown"
-            ],
-            "type": [
-              "null",
-              "object"
-            ]
-          }
-        },
-        "required": [
-          "brand_ids",
-          "merchant_ids",
-          "availability",
-          "price",
-          "attributes"
-        ],
-        "type": "object"
-      },
-      "evaluated_at": {
-        "type": "string"
-      },
-      "facets": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "buckets": {
-              "items": {
-                "additionalProperties": false,
-                "properties": {
-                  "count": {
-                    "type": "integer"
-                  },
-                  "name": {
-                    "type": "string"
-                  },
-                  "selected": {
-                    "type": "boolean"
-                  },
-                  "value": {
-                    "type": "string"
-                  }
-                },
-                "required": [
-                  "value",
-                  "name",
-                  "count",
-                  "selected"
-                ],
-                "type": "object"
-              },
-              "type": [
-                "null",
-                "array"
-              ]
-            },
-            "key": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "key",
-            "buckets"
-          ],
-          "type": "object"
-        },
-        "type": [
-          "null",
-          "array"
-        ]
-      },
-      "has_more": {
-        "type": "boolean"
-      },
-      "locale": {
-        "type": "string"
-      },
-      "market_id": {
-        "type": "string"
-      },
-      "next_cursor": {
-        "type": "string"
-      },
-      "page": {
-        "type": "integer"
-      },
-      "page_count": {
-        "type": "integer"
-      },
-      "price_coverage": {
-        "additionalProperties": false,
-        "properties": {
-          "complete_total": {
-            "type": "integer"
-          },
-          "item_only": {
-            "type": "integer"
-          },
-          "unpriced": {
-            "type": "integer"
-          }
-        },
-        "required": [
-          "complete_total",
-          "item_only",
-          "unpriced"
-        ],
-        "type": "object"
-      },
-      "query": {
-        "type": "string"
-      },
-      "result_unit": {
-        "type": "string"
-      },
-      "results": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "brand_id": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "brand_name": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "category_id": {
-              "type": "string"
-            },
-            "complete_offer_count": {
-              "type": "integer"
-            },
-            "image_url": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "lowest_complete_total_quote": {
-              "additionalProperties": false,
-              "properties": {
-                "amount_minor": {
-                  "type": "string"
-                },
-                "delivery_known": {
-                  "type": "boolean"
-                },
-                "listing_id": {
-                  "type": "string"
-                },
-                "merchant_id": {
-                  "type": "string"
-                },
-                "merchant_name": {
-                  "type": "string"
-                },
-                "missing_fields": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": [
-                    "null",
-                    "array"
-                  ]
-                },
-                "observed_at": {
-                  "type": "string"
-                },
-                "source_name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "listing_id",
-                "merchant_id",
-                "merchant_name",
-                "source_name",
-                "observed_at",
-                "amount_minor",
-                "missing_fields",
-                "delivery_known"
-              ],
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "lowest_item_subtotal_quote": {
-              "additionalProperties": false,
-              "properties": {
-                "amount_minor": {
-                  "type": "string"
-                },
-                "delivery_known": {
-                  "type": "boolean"
-                },
-                "listing_id": {
-                  "type": "string"
-                },
-                "merchant_id": {
-                  "type": "string"
-                },
-                "merchant_name": {
-                  "type": "string"
-                },
-                "missing_fields": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": [
-                    "null",
-                    "array"
-                  ]
-                },
-                "observed_at": {
-                  "type": "string"
-                },
-                "source_name": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "listing_id",
-                "merchant_id",
-                "merchant_name",
-                "source_name",
-                "observed_at",
-                "amount_minor",
-                "missing_fields",
-                "delivery_known"
-              ],
-              "type": [
-                "null",
-                "object"
-              ]
-            },
-            "match_reason": {
-              "type": "string"
-            },
-            "matching_offer_count": {
-              "type": "integer"
-            },
-            "matching_seller_count": {
-              "type": "integer"
-            },
-            "name": {
-              "type": "string"
-            },
-            "name_locale": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "product_id": {
-              "type": "string"
-            },
-            "slug": {
-              "type": [
-                "null",
-                "string"
-              ]
-            },
-            "sort_group": {
-              "type": "integer"
-            },
-            "variant_id": {
-              "type": "string"
-            },
-            "variant_label": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "product_id",
-            "variant_id",
-            "variant_label",
-            "name",
-            "name_locale",
-            "slug",
-            "brand_id",
-            "brand_name",
-            "category_id",
-            "image_url",
-            "matching_offer_count",
-            "matching_seller_count",
-            "complete_offer_count",
-            "lowest_complete_total_quote",
-            "lowest_item_subtotal_quote",
-            "match_reason",
-            "sort_group"
-          ],
-          "type": "object"
-        },
-        "type": [
-          "null",
-          "array"
-        ]
-      },
-      "revision": {
-        "type": "integer"
-      },
-      "schema_version": {
-        "type": "string"
-      },
-      "sort": {
-        "type": "string"
-      },
-      "sort_attribute_key": {
-        "type": "string"
-      },
-      "total_count": {
-        "type": "integer"
-      }
-    },
-    "required": [
-      "schema_version",
-      "result_unit",
-      "market_id",
-      "locale",
-      "query",
-      "context",
-      "category_id",
-      "effective_filters",
-      "catalog_scope",
-      "sort",
-      "sort_attribute_key",
-      "total_count",
-      "count_relation",
-      "count_capped",
-      "facets",
-      "attribute_facets",
-      "price_coverage",
-      "results",
-      "has_more",
-      "next_cursor",
-      "page",
-      "page_count",
-      "revision",
-      "evaluated_at",
-      "attribution"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "error": {
-        "additionalProperties": false,
-        "properties": {
-          "code": {
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          },
-          "policy": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "retry_after_seconds": {
-            "type": [
-              "null",
-              "integer"
-            ]
-          },
-          "retryable": {
-            "type": "boolean"
-          }
-        },
-        "required": [
-          "code",
-          "message",
-          "retryable"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "error"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attribute_facets": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "buckets": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "count": {
+                    "type": "integer"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "selected": {
+                    "type": "boolean"
+                  },
+                  "value": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "value",
+                  "name",
+                  "count",
+                  "selected"
+                ],
+                "type": "object"
+              },
+              "type": [
+                "null",
+                "array"
+              ]
+            },
+            "conflict_count": {
+              "type": "integer"
+            },
+            "has_more_values": {
+              "type": "boolean"
+            },
+            "key": {
+              "type": "string"
+            },
+            "known_count": {
+              "type": "integer"
+            },
+            "known_max": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "known_min": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "not_applicable_count": {
+              "type": "integer"
+            },
+            "unknown_count": {
+              "type": "integer"
+            },
+            "value_type": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "key",
+            "value_type",
+            "known_count",
+            "conflict_count",
+            "unknown_count",
+            "not_applicable_count",
+            "known_min",
+            "known_max",
+            "buckets",
+            "has_more_values"
+          ],
+          "type": "object"
+        },
+        "type": [
+          "null",
+          "array"
+        ]
+      },
+      "attribution": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "text": {
+              "type": "string"
+            },
+            "url": {
+              "type": [
+                "null",
+                "string"
+              ]
+            }
+          },
+          "required": [
+            "text",
+            "url"
+          ],
+          "type": "object"
+        },
+        "type": [
+          "null",
+          "array"
+        ]
+      },
+      "catalog_scope": {
+        "type": "string"
+      },
+      "category_id": {
+        "type": "string"
+      },
+      "context": {
+        "additionalProperties": false,
+        "properties": {
+          "audience": {
+            "type": "string"
+          },
+          "context_key": {
+            "type": "string"
+          },
+          "currency": {
+            "type": "string"
+          },
+          "currency_exponent": {
+            "type": "integer"
+          },
+          "destination_country": {
+            "type": "string"
+          },
+          "filters": {
+            "additionalProperties": false,
+            "properties": {
+              "availability": {
+                "type": "string"
+              },
+              "condition": {
+                "type": "string"
+              },
+              "merchant_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "condition",
+              "availability",
+              "merchant_id"
+            ],
+            "type": "object"
+          },
+          "market_id": {
+            "type": "string"
+          },
+          "quantity": {
+            "type": "string"
+          },
+          "quantity_unit": {
+            "type": "string"
+          },
+          "sort": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "market_id",
+          "currency",
+          "currency_exponent",
+          "destination_country",
+          "context_key",
+          "quantity",
+          "quantity_unit",
+          "audience",
+          "sort",
+          "filters"
+        ],
+        "type": "object"
+      },
+      "count_capped": {
+        "type": "boolean"
+      },
+      "count_relation": {
+        "type": "string"
+      },
+      "effective_filters": {
+        "additionalProperties": false,
+        "properties": {
+          "attributes": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "boolean_value": {
+                  "type": [
+                    "null",
+                    "boolean"
+                  ]
+                },
+                "include_unknown": {
+                  "type": "boolean"
+                },
+                "key": {
+                  "type": "string"
+                },
+                "max": {
+                  "type": [
+                    "null",
+                    "string"
+                  ]
+                },
+                "min": {
+                  "type": [
+                    "null",
+                    "string"
+                  ]
+                },
+                "operator": {
+                  "type": "string"
+                },
+                "option_ids": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": [
+                    "null",
+                    "array"
+                  ]
+                }
+              },
+              "required": [
+                "key",
+                "operator",
+                "min",
+                "max",
+                "option_ids",
+                "boolean_value",
+                "include_unknown"
+              ],
+              "type": "object"
+            },
+            "type": [
+              "null",
+              "array"
+            ]
+          },
+          "availability": {
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "null",
+              "array"
+            ]
+          },
+          "brand_ids": {
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "null",
+              "array"
+            ]
+          },
+          "merchant_ids": {
+            "items": {
+              "type": "string"
+            },
+            "type": [
+              "null",
+              "array"
+            ]
+          },
+          "price": {
+            "additionalProperties": false,
+            "properties": {
+              "basis": {
+                "type": "string"
+              },
+              "include_unknown": {
+                "type": "boolean"
+              },
+              "max_minor": {
+                "type": [
+                  "null",
+                  "string"
+                ]
+              },
+              "min_minor": {
+                "type": [
+                  "null",
+                  "string"
+                ]
+              }
+            },
+            "required": [
+              "basis",
+              "min_minor",
+              "max_minor",
+              "include_unknown"
+            ],
+            "type": [
+              "null",
+              "object"
+            ]
+          }
+        },
+        "required": [
+          "brand_ids",
+          "merchant_ids",
+          "availability",
+          "price",
+          "attributes"
+        ],
+        "type": "object"
+      },
+      "evaluated_at": {
+        "type": "string"
+      },
+      "facets": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "buckets": {
+              "items": {
+                "additionalProperties": false,
+                "properties": {
+                  "count": {
+                    "type": "integer"
+                  },
+                  "name": {
+                    "type": "string"
+                  },
+                  "selected": {
+                    "type": "boolean"
+                  },
+                  "value": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "value",
+                  "name",
+                  "count",
+                  "selected"
+                ],
+                "type": "object"
+              },
+              "type": [
+                "null",
+                "array"
+              ]
+            },
+            "key": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "key",
+            "buckets"
+          ],
+          "type": "object"
+        },
+        "type": [
+          "null",
+          "array"
+        ]
+      },
+      "has_more": {
+        "type": "boolean"
+      },
+      "locale": {
+        "type": "string"
+      },
+      "market_id": {
+        "type": "string"
+      },
+      "next_cursor": {
+        "type": "string"
+      },
+      "page": {
+        "type": "integer"
+      },
+      "page_count": {
+        "type": "integer"
+      },
+      "price_coverage": {
+        "additionalProperties": false,
+        "properties": {
+          "complete_total": {
+            "type": "integer"
+          },
+          "item_only": {
+            "type": "integer"
+          },
+          "unpriced": {
+            "type": "integer"
+          }
+        },
+        "required": [
+          "complete_total",
+          "item_only",
+          "unpriced"
+        ],
+        "type": "object"
+      },
+      "query": {
+        "type": "string"
+      },
+      "result_unit": {
+        "type": "string"
+      },
+      "results": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "brand_id": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "brand_name": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "category_id": {
+              "type": "string"
+            },
+            "complete_offer_count": {
+              "type": "integer"
+            },
+            "image_url": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "lowest_complete_total_quote": {
+              "additionalProperties": false,
+              "properties": {
+                "amount_minor": {
+                  "type": "string"
+                },
+                "currency": {
+                  "type": "string"
+                },
+                "currency_exponent": {
+                  "type": "integer"
+                },
+                "delivery_known": {
+                  "type": "boolean"
+                },
+                "listing_id": {
+                  "type": "string"
+                },
+                "merchant_id": {
+                  "type": "string"
+                },
+                "merchant_name": {
+                  "type": "string"
+                },
+                "missing_fields": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": [
+                    "null",
+                    "array"
+                  ]
+                },
+                "observed_at": {
+                  "type": "string"
+                },
+                "purchase_url": {
+                  "type": [
+                    "null",
+                    "string"
+                  ]
+                },
+                "source_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "listing_id",
+                "merchant_id",
+                "merchant_name",
+                "source_name",
+                "observed_at",
+                "amount_minor",
+                "currency",
+                "currency_exponent",
+                "missing_fields",
+                "delivery_known",
+                "purchase_url"
+              ],
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "lowest_item_subtotal_quote": {
+              "additionalProperties": false,
+              "properties": {
+                "amount_minor": {
+                  "type": "string"
+                },
+                "currency": {
+                  "type": "string"
+                },
+                "currency_exponent": {
+                  "type": "integer"
+                },
+                "delivery_known": {
+                  "type": "boolean"
+                },
+                "listing_id": {
+                  "type": "string"
+                },
+                "merchant_id": {
+                  "type": "string"
+                },
+                "merchant_name": {
+                  "type": "string"
+                },
+                "missing_fields": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": [
+                    "null",
+                    "array"
+                  ]
+                },
+                "observed_at": {
+                  "type": "string"
+                },
+                "purchase_url": {
+                  "type": [
+                    "null",
+                    "string"
+                  ]
+                },
+                "source_name": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "listing_id",
+                "merchant_id",
+                "merchant_name",
+                "source_name",
+                "observed_at",
+                "amount_minor",
+                "currency",
+                "currency_exponent",
+                "missing_fields",
+                "delivery_known",
+                "purchase_url"
+              ],
+              "type": [
+                "null",
+                "object"
+              ]
+            },
+            "match_reason": {
+              "type": "string"
+            },
+            "matching_offer_count": {
+              "type": "integer"
+            },
+            "matching_seller_count": {
+              "type": "integer"
+            },
+            "name": {
+              "type": "string"
+            },
+            "name_locale": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "product_id": {
+              "type": "string"
+            },
+            "product_url": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "slug": {
+              "type": [
+                "null",
+                "string"
+              ]
+            },
+            "sort_group": {
+              "type": "integer"
+            },
+            "variant_id": {
+              "type": "string"
+            },
+            "variant_label": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "product_id",
+            "variant_id",
+            "variant_label",
+            "name",
+            "name_locale",
+            "slug",
+            "brand_id",
+            "brand_name",
+            "category_id",
+            "product_url",
+            "image_url",
+            "matching_offer_count",
+            "matching_seller_count",
+            "complete_offer_count",
+            "lowest_complete_total_quote",
+            "lowest_item_subtotal_quote",
+            "match_reason",
+            "sort_group"
+          ],
+          "type": "object"
+        },
+        "type": [
+          "null",
+          "array"
+        ]
+      },
+      "revision": {
+        "type": "integer"
+      },
+      "schema_version": {
+        "type": "string"
+      },
+      "sort": {
+        "type": "string"
+      },
+      "sort_attribute_key": {
+        "type": "string"
+      },
+      "total_count": {
+        "type": "integer"
+      }
+    },
+    "required": [
+      "schema_version",
+      "result_unit",
+      "market_id",
+      "locale",
+      "query",
+      "context",
+      "category_id",
+      "effective_filters",
+      "catalog_scope",
+      "sort",
+      "sort_attribute_key",
+      "total_count",
+      "count_relation",
+      "count_capped",
+      "facets",
+      "attribute_facets",
+      "price_coverage",
+      "results",
+      "has_more",
+      "next_cursor",
+      "page",
+      "page_count",
+      "revision",
+      "evaluated_at",
+      "attribution"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "error": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "policy": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "retry_after_seconds": {
+            "type": [
+              "null",
+              "integer"
+            ]
+          },
+          "retryable": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "code",
+          "message",
+          "retryable"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "error"
+    ],
+    "type": "object"
+  }
+]
  2. First observed

TDQS

A4.4/5.0
Behavior3/5

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

Annotations already declare readOnly, idempotent, non-destructive, so the safety profile is covered; the description adds genuinely useful behavioral context such as prefix matching, umlaut transliteration, ignored size units, and null-means-unknown. It also discloses the commercial relationship and instructs the agent to say so when giving the purchase_url, which is real behavioral detail beyond annotations. It stops short of describing scoring/ranking or pagination edge cases, so it sits at solidly adequate rather than exceptional.

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?

Front-loaded with purpose and query syntax before moving to output semantics and disclaimers, and nearly every sentence carries actionable information. It is long and dense, and the output-field enumeration partly duplicates the output schema, so it is efficient rather than surgically tight.

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?

For a read-only search with a rich schema and an output schema, the description covers query syntax, required-parameter sourcing, retry behavior on empty results, result caveats (candidates not recommendations, may include accessories), and freshness/citation obligations. Nothing an agent needs in order to call or interpret it correctly is missing.

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

Parameters4/5

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

Schema coverage is 88%, so the baseline is 3; the description earns an extra point by defining the matching semantics of q far beyond the schema's 'Deterministic text or exact identifier query' (prefix rules, umlaut folding, size-unit stripping) and by stating where the four market parameters must come from. brand_id and cursor are not elaborated, which keeps it from a 5.

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 ('Find products in a market') plus the two query modes (words vs. exact GTIN/model identifier). It explicitly names the siblings it is not, list_offers and list_price_drops, so an agent can route correctly without opening schemas.

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?

Gives explicit when-to-use alternatives ('use list_offers instead when you need every seller of one variant; use list_price_drops when the person asks what is priced lower than usual') and prerequisite sourcing ('market_id, locale, currency and destination_country are required: take them from list_markets'). It even covers a failure path: on zero results, retry with fewer or broader words.

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

All Tallybuy toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources