Server definition
- Hash
- sha256:60fda58ce419616ea85493296e8288483b032179dadf1406bd693554f2165c4a
- What it is
- What a remote MCP server returned when asked what it offers: 11 tools
The blob, as servednamed by its sha256
{
"instructions": "Use the shopping market already supplied in the conversation; ask when unknown and do not infer it from language. Use price_basis delivered for shopping budgets, details, offers and comparisons; item preserves legacy item-price semantics. Unknown shipping is not free and stock is unverified. Retirement dates are estimates. For any price history, price trend or Preisentwicklung request, call get_retail_price_history FIRST and use assess_deal for current-offer comparisons. For the last 12 months request days 365. Show the available retailer observations even when they cover only part of the requested window, and state their actual dates; partial coverage does not mean no merchant history. Never substitute market valuations for unavailable, partial or failed retailer history. Use get_price_history ONLY when the user explicitly asks for collector value, resale valuation or Marktwert, or requests that separate series in addition. For gifts use the brickfact-shopping skill. Call render_sets with final chosen IDs for shopping cards or comparison. Only public catalogue data is available. The card shortlist is not synced to an account, and app handoffs do not create alerts or account wishlists.",
"tools": [
{
"description": "Compare the freshest known delivered offer with the recorded retail low and show coverage. No all-time-low claims or predictions. History excludes Amazon; current offers can include Amazon.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"days": {
"default": 365,
"description": "Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown.",
"maximum": 730,
"minimum": 1,
"type": "integer"
},
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "assess_deal",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"assessment": {
"enum": [
"at_or_below_recorded_low",
"above_recorded_low",
"insufficient_history",
"no_delivered_offer"
],
"type": "string"
},
"average": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"coverage": {
"additionalProperties": false,
"properties": {
"last_observed_day": {
"type": [
"string",
"null"
]
},
"missing_days": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"requested_end_day": {
"type": "string"
},
"requested_start_day": {
"type": "string"
},
"status": {
"enum": [
"none",
"partial",
"complete"
],
"type": "string"
}
},
"required": [
"status",
"requested_start_day",
"requested_end_day",
"last_observed_day",
"missing_days"
],
"type": "object"
},
"currency": {
"type": "string"
},
"current_retailer": {
"type": [
"string",
"null"
]
},
"current_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"days": {
"type": "number"
},
"difference_from_recorded_low_percent": {
"type": [
"number",
"null"
]
},
"excluded_retailers": {
"items": {
"type": "string"
},
"type": "array"
},
"first_observed_day": {
"type": [
"string",
"null"
]
},
"kind": {
"const": "retail_offer_history",
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"max": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"observation_days": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"points": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"retailer_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"value": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"date",
"value",
"retailer_id"
],
"type": "object"
},
"type": "array"
},
"price_basis": {
"const": "delivered",
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"set_id",
"market",
"currency",
"comparison_url",
"kind",
"price_basis",
"days",
"points",
"coverage",
"observation_days",
"first_observed_day",
"last_observed_at",
"min",
"max",
"average",
"excluded_retailers",
"notes",
"current_total",
"current_retailer",
"difference_from_recorded_low_percent",
"assessment"
],
"type": "object"
}
},
{
"description": "Compare specifications, retirement status and monitored offers for two to four distinct set numbers in the same retailer market.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"price_basis": {
"default": "item",
"enum": [
"item",
"delivered"
],
"type": "string"
},
"set_ids": {
"items": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"maxItems": 4,
"minItems": 2,
"type": "array"
}
},
"required": [
"market",
"set_ids"
],
"type": "object"
},
"name": "compare_sets",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"sets": {
"items": {
"additionalProperties": false,
"properties": {
"age_recommendation": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"type": "string"
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"lowest_known_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"minifigures": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"feed_updated_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
"item_price": {
"exclusiveMinimum": 0,
"type": "number"
},
"retailer": {
"type": "string"
},
"retailer_id": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"shipping": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"stock_status": {
"const": "not_verified",
"type": "string"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"type": "object"
},
"type": "array"
},
"pieces": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_date_is_estimate": {
"type": "boolean"
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"rrp": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"market",
"currency",
"price_basis",
"offers",
"lowest_known_total",
"lowest_item_price",
"notes",
"rrp",
"age_recommendation",
"minifigures",
"dimensions_cm",
"retirement_year",
"retirement_month",
"retirement_date_is_estimate"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"market",
"sets"
],
"type": "object"
}
},
{
"description": "Find curated related sets, optionally cheaper by delivered price or with fewer pieces, and optionally within a delivered-price budget. Candidate coverage is bounded; fewer pieces does not establish physical dimensions.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"limit": {
"default": 4,
"maximum": 6,
"minimum": 1,
"type": "integer"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"max_price": {
"exclusiveMinimum": 0,
"maximum": 100000,
"type": "number"
},
"preference": {
"default": "similar",
"enum": [
"similar",
"cheaper",
"fewer_pieces"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "find_alternatives",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"sets": {
"items": {
"additionalProperties": false,
"properties": {
"age_recommendation": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"type": "string"
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"lowest_known_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"minifigures": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"feed_updated_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
"item_price": {
"exclusiveMinimum": 0,
"type": "number"
},
"retailer": {
"type": "string"
},
"retailer_id": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"shipping": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"stock_status": {
"const": "not_verified",
"type": "string"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"type": "object"
},
"type": "array"
},
"pieces": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_date_is_estimate": {
"type": "boolean"
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"rrp": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"market",
"currency",
"price_basis",
"offers",
"lowest_known_total",
"lowest_item_price",
"notes",
"rrp",
"age_recommendation",
"minifigures",
"dimensions_cm",
"retirement_year",
"retirement_month",
"retirement_date_is_estimate"
],
"type": "object"
},
"type": "array"
},
"source_set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"source_set_id",
"sets",
"notes"
],
"type": "object"
}
},
{
"description": "Get the existing app link and steps for setting a price alert or saving a set to a Brickfact watchlist. This read-only handoff does not create anything. A target_price is an optional draft in the market currency; the user completes the action in the app.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"price_alert",
"wishlist"
],
"type": "string"
},
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"target_price": {
"exclusiveMinimum": 0,
"maximum": 100000,
"type": "number"
}
},
"required": [
"market",
"set_id",
"action"
],
"type": "object"
},
"name": "get_app_handoff",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"price_alert",
"wishlist"
],
"type": "string"
},
"app_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"created": {
"const": false,
"type": "boolean"
},
"currency": {
"type": "string"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"steps": {
"items": {
"type": "string"
},
"type": "array"
},
"target_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"set_id",
"market",
"currency",
"action",
"target_price",
"created",
"app_url",
"comparison_url",
"steps",
"notes"
],
"type": "object"
}
},
{
"description": "Only for explicit collector, resale or sealed-set market-valuation requests. For price history, price development, Preisentwicklung or past shop prices, call get_retail_price_history first. Never use this tool as a fallback for partial or unavailable retailer history. Values are EUR collector valuations, not retailer prices or predictions.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"price_basis": {
"default": "item",
"enum": [
"item",
"delivered"
],
"type": "string"
},
"range": {
"default": "1Y",
"enum": [
"1M",
"3M",
"1Y",
"YTD",
"ALL"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "get_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"average": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"const": "EUR",
"type": "string"
},
"kind": {
"const": "market_valuation",
"type": "string"
},
"max": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"points": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"value": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"date",
"value"
],
"type": "object"
},
"type": "array"
},
"range": {
"default": "1Y",
"enum": [
"1M",
"3M",
"1Y",
"YTD",
"ALL"
],
"type": "string"
},
"set_id": {
"type": "number"
}
},
"required": [
"set_id",
"comparison_url",
"currency",
"kind",
"range",
"points",
"average",
"min",
"max",
"notes"
],
"type": "object"
}
},
{
"description": "First choice for price history, price trends, Preisentwicklung and past merchant prices. Read recorded delivered retailer prices in the selected market and currency. Use days 365 for the last 12 months. Partial coverage is valid history: show available observations and actual dates instead of saying no history. Amazon and unknown shipping are excluded. Do not substitute collector market valuations.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"days": {
"default": 365,
"description": "Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown.",
"maximum": 730,
"minimum": 1,
"type": "integer"
},
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "get_retail_price_history",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"average": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"coverage": {
"additionalProperties": false,
"properties": {
"last_observed_day": {
"type": [
"string",
"null"
]
},
"missing_days": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"requested_end_day": {
"type": "string"
},
"requested_start_day": {
"type": "string"
},
"status": {
"enum": [
"none",
"partial",
"complete"
],
"type": "string"
}
},
"required": [
"status",
"requested_start_day",
"requested_end_day",
"last_observed_day",
"missing_days"
],
"type": "object"
},
"currency": {
"type": "string"
},
"days": {
"type": "number"
},
"excluded_retailers": {
"items": {
"type": "string"
},
"type": "array"
},
"first_observed_day": {
"type": [
"string",
"null"
]
},
"kind": {
"const": "retail_offer_history",
"type": "string"
},
"last_observed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"max": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"observation_days": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"points": {
"items": {
"additionalProperties": false,
"properties": {
"date": {
"type": "string"
},
"retailer_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"value": {
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"date",
"value",
"retailer_id"
],
"type": "object"
},
"type": "array"
},
"price_basis": {
"const": "delivered",
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"set_id",
"market",
"currency",
"comparison_url",
"kind",
"price_basis",
"days",
"points",
"coverage",
"observation_days",
"first_observed_day",
"last_observed_at",
"min",
"max",
"average",
"excluded_retailers",
"notes"
],
"type": "object"
}
},
{
"description": "Look up a set's specifications, retirement information and monitored offers. Future retirement dates are estimates. Reported shipping totals and unverified stock are explicitly labelled.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"price_basis": {
"default": "item",
"enum": [
"item",
"delivered"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "get_set_details",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"age_recommendation": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"type": "string"
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"lowest_known_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"minifigures": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"feed_updated_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
"item_price": {
"exclusiveMinimum": 0,
"type": "number"
},
"retailer": {
"type": "string"
},
"retailer_id": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"shipping": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"stock_status": {
"const": "not_verified",
"type": "string"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"type": "object"
},
"type": "array"
},
"pieces": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_date_is_estimate": {
"type": "boolean"
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"rrp": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"market",
"currency",
"price_basis",
"offers",
"lowest_known_total",
"lowest_item_price",
"notes",
"rrp",
"age_recommendation",
"minifigures",
"dimensions_cm",
"retirement_year",
"retirement_month",
"retirement_date_is_estimate"
],
"type": "object"
}
},
{
"description": "Find monitored retailer offers for one set in a supported market. Compare item prices and reported shipping totals. Unknown shipping is not free shipping. Results do not guarantee stock or checkout prices.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"price_basis": {
"default": "item",
"enum": [
"item",
"delivered"
],
"type": "string"
},
"set_id": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
}
},
"required": [
"market",
"set_id"
],
"type": "object"
},
"name": "get_set_offers",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"lowest_known_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"name": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"feed_updated_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
"item_price": {
"exclusiveMinimum": 0,
"type": "number"
},
"retailer": {
"type": "string"
},
"retailer_id": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"shipping": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"stock_status": {
"const": "not_verified",
"type": "string"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"type": "object"
},
"type": "array"
},
"pieces": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"market",
"currency",
"price_basis",
"offers",
"lowest_known_total",
"lowest_item_price",
"notes"
],
"type": "object"
}
},
{
"description": "Find catalogue theme IDs and names, optionally by text. Theme IDs can be used to narrow a set search.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"query": {
"maxLength": 100,
"type": "string"
}
},
"required": [
"market"
],
"type": "object"
},
"name": "list_themes",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"themes": {
"items": {
"additionalProperties": false,
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"id",
"name",
"slug"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"market",
"themes"
],
"type": "object"
}
},
{
"description": "After searching or choosing sets, show the final one to six set IDs as shopping cards, or two to four as a side-by-side comparison. Includes images, reported delivered prices, card shortlist and app handoffs. Data remains available without UI.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"set_ids": {
"items": {
"maximum": 2147483647,
"minimum": 1,
"type": "integer"
},
"maxItems": 6,
"minItems": 1,
"type": "array"
},
"view": {
"default": "cards",
"enum": [
"cards",
"comparison"
],
"type": "string"
}
},
"required": [
"market",
"set_ids"
],
"type": "object"
},
"name": "render_sets",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"language": {
"type": "string"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"sets": {
"items": {
"additionalProperties": false,
"properties": {
"age_recommendation": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"currency": {
"type": "string"
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"lowest_item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"lowest_known_total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"minifigures": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"offers": {
"items": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"feed_updated_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$",
"type": "string"
},
"item_price": {
"exclusiveMinimum": 0,
"type": "number"
},
"retailer": {
"type": "string"
},
"retailer_id": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"shipping": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"stock_status": {
"const": "not_verified",
"type": "string"
},
"total": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"type": "object"
},
"type": "array"
},
"pieces": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_date_is_estimate": {
"type": "boolean"
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"rrp": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"market",
"currency",
"price_basis",
"offers",
"lowest_known_total",
"lowest_item_price",
"notes",
"rrp",
"age_recommendation",
"minifigures",
"dimensions_cm",
"retirement_year",
"retirement_month",
"retirement_date_is_estimate"
],
"type": "object"
},
"type": "array"
},
"view": {
"enum": [
"cards",
"comparison"
],
"type": "string"
}
},
"required": [
"market",
"language",
"view",
"sets",
"notes"
],
"type": "object"
}
},
{
"description": "Find sets by name or number, theme IDs, budget, pieces, age recommendation or retirement status. Use price_basis delivered for budgets including shipping; item preserves the original item-only search. Delivered search excludes unknown shipping before pagination. Returns links to Brickfact comparison pages.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"age_recommendations": {
"items": {
"pattern": "^\\d{1,2}\\+$",
"type": "string"
},
"maxItems": 10,
"type": "array"
},
"current_offers_only": {
"default": true,
"type": "boolean"
},
"language": {
"description": "Preferred result language. Comparison-page links always keep the selected retailer market.",
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string"
},
"limit": {
"default": 10,
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"market": {
"description": "Retailer market. Required; ask when unknown.",
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"max_pieces": {
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"max_price": {
"maximum": 100000,
"minimum": 0,
"type": "number"
},
"min_pieces": {
"maximum": 100000,
"minimum": 0,
"type": "integer"
},
"min_price": {
"maximum": 100000,
"minimum": 0,
"type": "number"
},
"page": {
"default": 1,
"maximum": 1000,
"minimum": 1,
"type": "integer"
},
"price_basis": {
"default": "item",
"enum": [
"item",
"delivered"
],
"type": "string"
},
"query": {
"maxLength": 200,
"type": "string"
},
"retirement": {
"default": "any",
"enum": [
"any",
"retiring_soon",
"retired"
],
"type": "string"
},
"retirement_year": {
"maximum": 2100,
"minimum": 1950,
"type": "integer"
},
"sort": {
"default": "price_asc",
"enum": [
"price_asc",
"price_desc",
"discount",
"newest"
],
"type": "string"
},
"theme_ids": {
"items": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"maxItems": 10,
"type": "array"
}
},
"required": [
"market"
],
"type": "object"
},
"name": "search_sets",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"notes": {
"items": {
"type": "string"
},
"type": "array"
},
"page": {
"type": "number"
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"sets": {
"items": {
"additionalProperties": false,
"properties": {
"comparison_url": {
"pattern": "^https:\\/\\/brickfact\\.com\\/",
"type": "string"
},
"image_url": {
"anyOf": [
{
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/",
"type": "string"
},
{
"type": "null"
}
]
},
"item_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"pieces": {
"type": [
"number",
"null"
]
},
"release_year": {
"type": [
"number",
"null"
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"rrp": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
},
"set_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"theme": {
"type": [
"string",
"null"
]
},
"total_price": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"item_price",
"total_price",
"rrp"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"market",
"currency",
"price_basis",
"sets",
"page",
"total",
"notes"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:60fda58ce419616ea85493296e8288483b032179dadf1406bd693554f2165c4a | sha256sum