Cursor
Grok Bot
Grok
MuseTitle99/100
Search idealo catalog
The title clearly communicates the tool’s action and subject. Keep it concise.
Description88/100
Search the idealo catalog and show an interactive results carousel. WIDGET CONTEXT (read first for follow-ups): After a search, read the idealo-search widget model context before answering about the current product, price, specs, offers, reviews, or pronouns like "this" / "it". The user may have changed selection since the last tool call. Refinement: markdown text includes availableCategories, availableManufacturers, availableFilters, sizeAttributes, and suggestedFilters for later calls; reuse their ids internally and use human-readable names with the user. Returns: content is markdown (products plus filter facets); structuredContent has query, results (productRef, itemType, siteId, name, price, …), appliedFilters, and searchResultsUrl.
The description explains the capability, when to use it, and what to expect.
Inputs93/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
query
What to find on idealo (product name, type, or keywords from the user request).
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
country
ISO 3166-1 alpha-2 marketplace when it should differ from the MCP client user location. Supported: DE, AT, GB, FR, IT, ES.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › minPrice
Minimum offer price in euros for the active marketplace.
Clear enough to supply this argument.
filters › maxPrice
Maximum offer price in euros for the active marketplace.
Clear enough to supply this argument.
filters › availableOnly
When true, limit to listings that are purchasable now.
Clear enough to supply this argument.
filters › bargainsOnly
When true, limit to listings flagged as bargains or discounts.
Clear enough to supply this argument.
filters › includeCategories
Category ids to narrow the catalog. Copy ids from availableCategories in the markdown text of a prior idealo-search response.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
filters › includeManufacturers
Brand ids to narrow the catalog. Copy manufacturerId values from availableManufacturers in a prior idealo-search response.
Clear enough to supply this argument.
filters › includeSearchFilters
Attribute filter ids (color, material, etc.) from availableFilters in a prior response. Use includeSizeFilters for clothing or shoe sizes.
Clear enough to supply this argument.
filters › includeSizeFilters
Size option ids from sizeAttributes in a prior response (attributeKeyValue strings).
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Output schema69/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query",
"results",
"searchResultsUrl"
],
"properties": {
"query": {
"type": "string",
"description": "Search string that was executed."
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"productRef",
"itemType",
"siteId",
"name",
"imageUrl"
],
"properties": {
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"price": {
"type": "string"
},
"badges": {
"type": "object",
"required": [
"bargain"
],
"properties": {
"bargain": {
"type": "object",
"required": [
"discountRate",
"tags"
],
"properties": {
"tags": {
"type": "array",
"items": {
"enum": [
"BLACK_FRIDAY",
"REGULAR",
"SHORTTERM"
],
"type": "string"
}
},
"discountRate": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"key",
"relocatorUrl",
"payments",
"showPaymentDisclaimer",
"price",
"basePrice",
"delivery",
"freeReturnDays",
"shop",
"cheapestTotalPriceOffer",
"freshness",
"minShippingCost",
"hasAlwaysFreeShipping"
],
"properties": {
"key": {
"type": "string"
},
"shop": {
"anyOf": [
{
"type": "object",
"required": [
"shopId",
"merchantId",
"name",
"merchantName",
"logoUrl",
"isMarketplace",
"rating"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"rating": {
"anyOf": [
{
"type": "object",
"required": [
"avg",
"count",
"url"
],
"properties": {
"avg": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"count": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"shopId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"logoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"merchantId": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"merchantName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"isMarketplace": {
"type": "boolean"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"delivery": {
"type": "object",
"required": [
"deliveryText",
"deliveryStatus",
"earlyDeliveryDate",
"lateDeliveryDate"
],
"properties": {
"deliveryText": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"deliveryStatus": {
"enum": [
"LONG",
"MEDIUM",
"SHORT",
"UNKNOWN"
],
"type": "string"
},
"lateDeliveryDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"earlyDeliveryDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"payments": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"required": [
"costCode",
"name"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"costCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
{
"type": "null"
}
]
},
"basePrice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"freshness": {
"type": "string"
},
"relocatorUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"freeReturnDays": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"minShippingCost": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hasAlwaysFreeShipping": {
"type": "boolean"
},
"showPaymentDisclaimer": {
"type": "boolean"
},
"cheapestTotalPriceOffer": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"siteId": {
"type": "number"
},
"imageUrl": {
"type": "string"
},
"itemType": {
"enum": [
"CLUSTER",
"PRODUCT",
"SINGLE_OFFER"
],
"type": "string"
},
"imageUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"nameDelta": {
"type": "string"
},
"nextOffset": {
"type": "number"
},
"priceTrend": {
"type": "object",
"required": [
"history"
],
"properties": {
"history": {
"type": "array",
"items": {
"type": "object",
"required": [
"dateTime",
"price"
],
"properties": {
"price": {
"type": "number"
},
"dateTime": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"productRef": {
"type": "string"
},
"testReports": {
"type": "object",
"properties": {
"list": {
"type": "array",
"items": {
"type": "object",
"required": [
"language",
"providerName",
"shortDescription",
"testedProductsCount"
],
"properties": {
"issue": {
"type": "string"
},
"logoUrl": {
"type": "string"
},
"language": {
"type": "string"
},
"externalUrl": {
"type": "string"
},
"publishedAt": {
"type": "number"
},
"ratingValue": {
"type": "string"
},
"summaryText": {
"type": "string"
},
"providerName": {
"type": "string"
},
"shortDescription": {
"type": "string"
},
"testedProductsCount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"summary": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"rating": {
"type": "string"
},
"ratingCount": {
"type": "number"
},
"averageRating": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"userReviews": {
"type": "object",
"properties": {
"list": {
"type": "object",
"required": [
"userReviews"
],
"properties": {
"userReviews": {
"type": "array",
"items": {
"type": "object",
"required": [
"verified"
],
"properties": {
"title": {
"type": "string"
},
"comment": {
"type": "string"
},
"language": {
"type": "string"
},
"verified": {
"type": "boolean"
},
"createdAt": {
"type": "number"
},
"ratingValue": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"summary": {
"type": "object",
"properties": {
"averageRating": {
"type": "number"
},
"totalReviewCount": {
"type": "number"
},
"ratingDistribution": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"rating",
"roundedPercentage"
],
"properties": {
"count": {
"type": "number"
},
"rating": {
"type": "number"
},
"roundedPercentage": {
"type": "number"
}
},
"additionalProperties": false
}
},
"providerDistribution": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"displayName",
"group"
],
"properties": {
"count": {
"type": "number"
},
"group": {
"type": "string"
},
"displayName": {
"type": "string"
}
},
"additionalProperties": false
}
},
"totalReviewWithCommentCount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"productOverview": {
"type": "array",
"items": {
"type": "string"
}
},
"totalOfferCount": {
"type": "number"
},
"productDetailsUrl": {
"type": "string"
},
"testReportsSummary": {
"type": "object",
"properties": {
"grade": {
"type": "string"
},
"rating": {
"type": "string"
},
"ratingCount": {
"type": "number"
},
"averageRating": {
"type": "number"
}
},
"additionalProperties": false
},
"userReviewsSummary": {
"type": "object",
"properties": {
"averageRating": {
"type": "number"
},
"totalReviewCount": {
"type": "number"
},
"ratingDistribution": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"rating",
"roundedPercentage"
],
"properties": {
"count": {
"type": "number"
},
"rating": {
"type": "number"
},
"roundedPercentage": {
"type": "number"
}
},
"additionalProperties": false
}
},
"providerDistribution": {
"type": "array",
"items": {
"type": "object",
"required": [
"count",
"displayName",
"group"
],
"properties": {
"count": {
"type": "number"
},
"group": {
"type": "string"
},
"displayName": {
"type": "string"
}
},
"additionalProperties": false
}
},
"totalReviewWithCommentCount": {
"type": "number"
}
},
"additionalProperties": false
},
"productSpecification": {
"type": "object",
"required": [
"groups"
],
"properties": {
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"type",
"attributes"
],
"properties": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"attributes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"description": "Product hits with productRef, itemType, siteId, name, price, imageUrl, and optional summaries or preview offers."
},
"appliedFilters": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"label"
],
"properties": {
"type": {
"enum": [
"category",
"brand",
"priceRange",
"size",
"bargain",
"attribute"
],
"type": "string"
},
"label": {
"type": "string"
},
"groupName": {
"type": "string"
}
},
"additionalProperties": false
},
"description": "Labels describing filters applied on this request."
},
"searchResultsUrl": {
"type": "string",
"description": "Regional idealo URL for the same search on the website, or empty when not built."
}
},
"additionalProperties": false
}