chrono24-mcp

Overview Schema Source Related Servers Discussions Admin

Get price statistics

get_price_stats

Read-only

Get price statistics for a watch on Chrono24: min, percentiles, max, sample size. Switch between cheapest mode for lower-tail bias or spread mode for full-range price estimates.

Instructions

Price statistics for a watch across Chrono24: min, percentiles (p10/p25/median/p75/p90), max and sample size. Default 'cheapest' mode is one polite request (lower-tail biased when >60 match); sample:'spread' adds up to 2 requests and interpolates percentiles across the full price range.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`year`	No
`query`	No	Free-text search scope
`facets`	No	Facet filters (caseMaterials, braceletMaterial, dialColors, gender, movementTypes, watchCategories, maxAgeInDays) - values via list_filters
`models`	No	Model id from find_models
`sample`	No	'cheapest' (1 request, lower-tail biased when >60 match) or 'spread' (up to 3 requests, ~8s more, full-range percentile estimate)	cheapest
`priceTo`	No	Maximum price
`condition`	No
`countries`	No
`priceFrom`	No	Minimum price
`manufacturerIds`	No	Brand id from list_brands
`referenceNumber`	No	Reference number filter

Output Schema

TableJSON Schema

Name	Required	Description
`note`	Yes
`scope`	Yes
`stats`	Yes
`cheapest`	Yes
`coverage`	Yes	'full': every matching listing sampled; 'cheapest-60': lower-tail bias; 'spread-sampled': percentiles interpolated from first/middle/last price-sorted pages
`currency`	Yes
`sourceUrl`	Yes
`totalCount`	Yes
`pagesSampled`	No
`ignoredFacets`	No	Facet keys that were ignored because they are not passthrough params (e.g. countryIds -> use 'countries', usedOrNew -> use 'condition')

Schema Changelog

Changes observed during successful MCP inspections.

Changed13 schema fields changedv0.6.0Sep 4, 2026

removedInput schema / additionalProperties
```
Removed value: -false
```

changedInput schema / properties / facets / description

Previous value: -"Facet filters, see list_filters"New value: +"Facet filters (caseMaterials, braceletMaterial, dialColors, gender, movementTypes, watchCategories, maxAgeInDays) - values via list_filters"

addedInput schema / properties / facets / propertyNames
```
Added value: +{
+  "type": "string"
+}
```

changedInput schema / properties / priceFrom / description

Previous value: -"Minimum price in USD"New value: +"Minimum price"

addedInput schema / properties / priceFrom / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / priceFrom / minimum
```
Added value: +-9007199254740991
```

changedInput schema / properties / priceTo / description

Previous value: -"Maximum price in USD"New value: +"Maximum price"

addedInput schema / properties / priceTo / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / priceTo / minimum
```
Added value: +-9007199254740991
```

addedInput schema / properties / sample

Added value: +{
+  "default": "cheapest",
+  "description": "'cheapest' (1 request, lower-tail biased when >60 match) or 'spread' (up to 3 requests, ~8s more, full-range percentile estimate)",
+  "enum": [
+    "cheapest",
+    "spread"
+  ],
+  "type": "string"
+}

addedInput schema / properties / year / maximum
```
Added value: +9007199254740991
```
addedInput schema / properties / year / minimum
```
Added value: +-9007199254740991
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "cheapest": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "badge": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "brandModel": {
+            "type": "string"
+          },
+          "detail": {
+            "type": "string"
+          },
+          "id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "imageUrl": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "location": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "negotiable": {
+            "type": "boolean"
+          },
+          "priceDisplay": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "priceValue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "sellerType": {
+            "anyOf": [
+              {
+                "enum": [
+                  "dealer",
+                  "private"
+                ],
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "url": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "url",
+          "brandModel",
+          "detail",
+          "priceDisplay",
+          "priceValue",
+          "negotiable",
+          "location",
+          "sellerType",
+          "badge",
+          "imageUrl"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "coverage": {
+      "anyOf": [
+        {
+          "enum": [
+            "full",
+            "cheapest-60",
+            "spread-sampled"
+          ],
+          "type": "string"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "description": "'full': every matching listing sampled; 'cheapest-60': lower-tail bias; 'spread-sampled': percentiles interpolated from first/middle/last price-sorted pages"
+    },
+    "currency": {
+      "type": "string"
+    },
+    "ignoredFacets": {
+      "description": "Facet keys that were ignored because they are not passthrough params (e.g. countryIds -> use 'countries', usedOrNew -> use 'condition')",
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "note": {
+      "type": "string"
+    },
+    "pagesSampled": {
+      "items": {
+        "type": "number"
+      },
+      "type": "array"
+    },
+    "scope": {
+      "additionalProperties": false,
+      "properties": {
+        "manufacturerIds": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "models": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "query": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "query",
+        "manufacturerIds",
+        "models"
+      ],
+      "type": "object"
+    },
+    "sourceUrl": {
+      "type": "string"
+    },
+    "stats": {
+      "anyOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "max": {
+              "type": "number"
+            },
+            "median": {
+              "type": "number"
+            },
+            "min": {
+              "type": "number"
+            },
+            "p10": {
+              "type": "number"
+            },
+            "p25": {
+              "type": "number"
+            },
+            "p75": {
+              "type": "number"
+            },
+            "p90": {
+              "type": "number"
+            },
+            "sampleSize": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "sampleSize",
+            "min",
+            "p10",
+            "p25",
+            "median",
+            "p75",
+            "p90",
+            "max"
+          ],
+          "type": "object"
+        },
+        {
+          "type": "null"
+        }
+      ]
+    },
+    "totalCount": {
+      "type": [
+        "number",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "scope",
+    "totalCount",
+    "sourceUrl",
+    "currency",
+    "coverage",
+    "stats",
+    "cheapest",
+    "note"
+  ],
+  "type": "object"
+}

First observedv0.4.0Aug 26, 2026

TDQS

A4.5/5.0

Behavior5/5

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

Beyond the readOnly/openWorld annotations, the description discloses request counts, the >60-match bias threshold, and the interpolation behavior of spread mode. This gives an agent the non-obvious cost and estimation-quality details needed to invoke the tool responsibly.

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?

Two dense sentences with no filler: the first states the deliverable and output fields, and the second explains the mode trade-off. The most important scoping and cost information is front-loaded.

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 an 11-parameter tool with an output schema and readOnly/openWorld annotations, the description covers the non-obvious behavioral pieces: estimation method, bias condition, and request budget. Remaining parameter details are already present in the schema, so nothing essential for correct invocation is missing.

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?

The schema already describes most parameters (73% coverage), including the sample modes and cross-references to list_filters, find_models, and list_brands. The description mostly restates the sample behavior rather than adding meaning for the other parameters, so it provides only marginal parameter-level value.

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 leads with the exact deliverable: 'Price statistics for a watch across Chrono24' and enumerates the specific outputs: min, p10/p25/median/p75/p90, max, and sample size. This clearly distinguishes it from listing-returning siblings like search_listings or get_watch.

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?

It explicitly explains when to use each sampling mode: default 'cheapest' is one polite request with lower-tail bias when >60 matches, while 'spread' adds requests and interpolates full-range percentiles. It does not explicitly name sibling tools as alternatives, but the mode-selection guidance is clear.

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