Brickfact LEGO Shopping is an MCP server published by io.github.brickfact-com, hosted at mcp.brickfact.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including search_sets, get_set_details, get_set_offers, compare_sets, get_price_history.
Find LEGO sets, compare regional retailer offers, and inspect recorded retail price history.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| sort | string | one of ["price_asc","price_desc","discount","newest"] |
| limit | integer | |
| query | string | |
| market * | string |
None yet. Changes appear after a server's second daily check.
| Retailer market. Required; ask when unknown. |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| max_price | number |
| min_price | number |
| theme_ids | array |
| max_pieces | integer |
| min_pieces | integer |
| retirement | string | one of ["any","retiring_soon","retired"] |
| price_basis | string | one of ["item","delivered"] |
| retirement_year | integer |
| age_recommendations | array |
| current_offers_only | boolean |
{
"name": "search_sets",
"title": "Find LEGO sets",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market"
],
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 1000,
"minimum": 1
},
"sort": {
"enum": [
"price_asc",
"price_desc",
"discount",
"newest"
],
"type": "string",
"default": "price_asc"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"max_price": {
"type": "number",
"maximum": 100000,
"minimum": 0
},
"min_price": {
"type": "number",
"maximum": 100000,
"minimum": 0
},
"theme_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"maxItems": 10
},
"max_pieces": {
"type": "integer",
"maximum": 100000,
"minimum": 0
},
"min_pieces": {
"type": "integer",
"maximum": 100000,
"minimum": 0
},
"retirement": {
"enum": [
"any",
"retiring_soon",
"retired"
],
"type": "string",
"default": "any"
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string",
"default": "item"
},
"retirement_year": {
"type": "integer",
"maximum": 2100,
"minimum": 1950
},
"age_recommendations": {
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{1,2}\\+$"
},
"maxItems": 10
},
"current_offers_only": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"currency",
"price_basis",
"sets",
"page",
"total",
"notes"
],
"properties": {
"page": {
"type": "number"
},
"sets": {
"type": "array",
"items": {
"type": "object",
"required": [
"set_id",
"name",
"image_url",
"theme",
"pieces",
"release_year",
"retirement_status",
"comparison_url",
"item_price",
"total_price",
"rrp"
],
"properties": {
"rrp": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"theme": {
"type": [
"string",
"null"
]
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"total_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"release_year": {
"type": [
"number",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"retirement_status": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"total": {
"type": "number"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"currency": {
"type": "string"
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| price_basis | string | one of ["item","delivered"] |
{
"name": "get_set_details",
"title": "Get set details",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string",
"default": "item"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"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"
],
"properties": {
"rrp": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"theme": {
"type": [
"string",
"null"
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"properties": {
"total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"retailer": {
"type": "string"
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"item_price": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"stock_status": {
"type": "string",
"const": "not_verified"
},
"feed_updated_at": {
"type": "string",
"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))$"
}
},
"additionalProperties": false
}
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"minifigures": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"lowest_item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"age_recommendation": {
"type": [
"string",
"null"
]
},
"lowest_known_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_date_is_estimate": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| price_basis | string | one of ["item","delivered"] |
{
"name": "get_set_offers",
"title": "Compare retailer offers",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string",
"default": "item"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"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"
],
"properties": {
"name": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"theme": {
"type": [
"string",
"null"
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"properties": {
"total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"retailer": {
"type": "string"
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"item_price": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"stock_status": {
"type": "string",
"const": "not_verified"
},
"feed_updated_at": {
"type": "string",
"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))$"
}
},
"additionalProperties": false
}
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"lowest_item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"lowest_known_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Compare specifications, retirement status and monitored offers for two to four distinct set numbers in the same retailer market.
| Parameter | Type | Description |
|---|---|---|
| market * | string | Retailer market. Required; ask when unknown. |
| set_ids * | array | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| price_basis | string | one of ["item","delivered"] |
{
"name": "compare_sets",
"title": "Compare sets",
"description": "Compare specifications, retirement status and monitored offers for two to four distinct set numbers in the same retailer market.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_ids"
],
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"maxItems": 4,
"minItems": 2
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string",
"default": "item"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"sets"
],
"properties": {
"sets": {
"type": "array",
"items": {
"type": "object",
"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"
],
"properties": {
"rrp": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"theme": {
"type": [
"string",
"null"
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"properties": {
"total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"retailer": {
"type": "string"
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"item_price": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"stock_status": {
"type": "string",
"const": "not_verified"
},
"feed_updated_at": {
"type": "string",
"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))$"
}
},
"additionalProperties": false
}
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"minifigures": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"lowest_item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"age_recommendation": {
"type": [
"string",
"null"
]
},
"lowest_known_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_date_is_estimate": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| range | string | one of ["1M","3M","1Y","YTD","ALL"] |
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| price_basis | string | one of ["item","delivered"] |
{
"name": "get_price_history",
"title": "Collector market value (explicit requests only)",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"range": {
"enum": [
"1M",
"3M",
"1Y",
"YTD",
"ALL"
],
"type": "string",
"default": "1Y"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string",
"default": "item"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"set_id",
"comparison_url",
"currency",
"kind",
"range",
"points",
"average",
"min",
"max",
"notes"
],
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"kind": {
"type": "string",
"const": "market_valuation"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"range": {
"enum": [
"1M",
"3M",
"1Y",
"YTD",
"ALL"
],
"type": "string",
"default": "1Y"
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"value"
],
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
}
},
"additionalProperties": false
}
},
"set_id": {
"type": "number"
},
"average": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string",
"const": "EUR"
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}Find catalogue theme IDs and names, optionally by text. Theme IDs can be used to narrow a set search.
| Parameter | Type | Description |
|---|---|---|
| query | string | |
| market * | string | Retailer market. Required; ask when unknown. |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
{
"name": "list_themes",
"title": "Find LEGO themes",
"description": "Find catalogue theme IDs and names, optionally by text. Theme IDs can be used to narrow a set search.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market"
],
"properties": {
"query": {
"type": "string",
"maxLength": 100
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"themes"
],
"properties": {
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"themes": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"slug"
],
"properties": {
"id": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown. |
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
{
"name": "get_retail_price_history",
"title": "Retailer price history (first choice for price trends)",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"days": {
"type": "integer",
"default": 365,
"maximum": 730,
"minimum": 1,
"description": "Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown."
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"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"
],
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"days": {
"type": "number"
},
"kind": {
"type": "string",
"const": "retail_offer_history"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"value",
"retailer_id"
],
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
}
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"average": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"coverage": {
"type": "object",
"required": [
"status",
"requested_start_day",
"requested_end_day",
"last_observed_day",
"missing_days"
],
"properties": {
"status": {
"enum": [
"none",
"partial",
"complete"
],
"type": "string"
},
"missing_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"last_observed_day": {
"type": [
"string",
"null"
]
},
"requested_end_day": {
"type": "string"
},
"requested_start_day": {
"type": "string"
}
},
"additionalProperties": false
},
"currency": {
"type": "string"
},
"price_basis": {
"type": "string",
"const": "delivered"
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"observation_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"excluded_retailers": {
"type": "array",
"items": {
"type": "string"
}
},
"first_observed_day": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | integer | Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown. |
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
{
"name": "assess_deal",
"title": "Assess a current offer",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"days": {
"type": "integer",
"default": 365,
"maximum": 730,
"minimum": 1,
"description": "Requested look-back window in days; use 365 for 12 months. Shorter recorded coverage is returned and must still be shown."
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"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"
],
"properties": {
"max": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"min": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"days": {
"type": "number"
},
"kind": {
"type": "string",
"const": "retail_offer_history"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"points": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"value",
"retailer_id"
],
"properties": {
"date": {
"type": "string"
},
"value": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
}
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"average": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"coverage": {
"type": "object",
"required": [
"status",
"requested_start_day",
"requested_end_day",
"last_observed_day",
"missing_days"
],
"properties": {
"status": {
"enum": [
"none",
"partial",
"complete"
],
"type": "string"
},
"missing_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"last_observed_day": {
"type": [
"string",
"null"
]
},
"requested_end_day": {
"type": "string"
},
"requested_start_day": {
"type": "string"
}
},
"additionalProperties": false
},
"currency": {
"type": "string"
},
"assessment": {
"enum": [
"at_or_below_recorded_low",
"above_recorded_low",
"insufficient_history",
"no_delivered_offer"
],
"type": "string"
},
"price_basis": {
"type": "string",
"const": "delivered"
},
"current_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"current_retailer": {
"type": [
"string",
"null"
]
},
"last_observed_at": {
"anyOf": [
{
"type": "string",
"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": "null"
}
]
},
"observation_days": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"excluded_retailers": {
"type": "array",
"items": {
"type": "string"
}
},
"first_observed_day": {
"type": [
"string",
"null"
]
},
"difference_from_recorded_low_percent": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| max_price | number | |
| preference | string | one of ["similar","cheaper","fewer_pieces"] |
{
"name": "find_alternatives",
"title": "Find alternative sets",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 4,
"maximum": 6,
"minimum": 1
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"max_price": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
"preference": {
"enum": [
"similar",
"cheaper",
"fewer_pieces"
],
"type": "string",
"default": "similar"
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"source_set_id",
"sets",
"notes"
],
"properties": {
"sets": {
"type": "array",
"items": {
"type": "object",
"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"
],
"properties": {
"rrp": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"theme": {
"type": [
"string",
"null"
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"properties": {
"total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"retailer": {
"type": "string"
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"item_price": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"stock_status": {
"type": "string",
"const": "not_verified"
},
"feed_updated_at": {
"type": "string",
"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))$"
}
},
"additionalProperties": false
}
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"minifigures": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"lowest_item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"age_recommendation": {
"type": [
"string",
"null"
]
},
"lowest_known_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_date_is_estimate": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"source_set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| view | string | one of ["cards","comparison"] |
| market * | string | Retailer market. Required; ask when unknown. |
| set_ids * | array | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
{
"name": "render_sets",
"title": "Show shopping cards or comparison",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_ids"
],
"properties": {
"view": {
"enum": [
"cards",
"comparison"
],
"type": "string",
"default": "cards"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_ids": {
"type": "array",
"items": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"maxItems": 6,
"minItems": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"language",
"view",
"sets",
"notes"
],
"properties": {
"sets": {
"type": "array",
"items": {
"type": "object",
"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"
],
"properties": {
"rrp": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"theme": {
"type": [
"string",
"null"
]
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"offers": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer_id",
"retailer",
"item_price",
"shipping",
"total",
"currency",
"feed_updated_at",
"stock_status"
],
"properties": {
"total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"retailer": {
"type": "string"
},
"shipping": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"item_price": {
"type": "number",
"exclusiveMinimum": 0
},
"retailer_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"stock_status": {
"type": "string",
"const": "not_verified"
},
"feed_updated_at": {
"type": "string",
"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))$"
}
},
"additionalProperties": false
}
},
"pieces": {
"type": [
"number",
"null"
]
},
"set_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"currency": {
"type": "string"
},
"image_url": {
"anyOf": [
{
"type": "string",
"pattern": "^https:\\/\\/image-cdn\\.brickfact\\.com\\/"
},
{
"type": "null"
}
]
},
"minifigures": {
"type": [
"number",
"null"
]
},
"price_basis": {
"enum": [
"item",
"delivered"
],
"type": "string"
},
"release_year": {
"type": [
"number",
"null"
]
},
"dimensions_cm": {
"type": [
"string",
"null"
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"retirement_year": {
"type": [
"number",
"null"
]
},
"retirement_month": {
"type": [
"number",
"null"
]
},
"lowest_item_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_status": {
"type": [
"string",
"null"
]
},
"age_recommendation": {
"type": [
"string",
"null"
]
},
"lowest_known_total": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"retirement_date_is_estimate": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"view": {
"enum": [
"cards",
"comparison"
],
"type": "string"
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"language": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| action * | string | one of ["price_alert","wishlist"] |
| market * | string | Retailer market. Required; ask when unknown. |
| set_id * | integer | |
| language | string | Preferred result language. Comparison-page links always keep the selected retailer market. |
| target_price | number |
{
"name": "get_app_handoff",
"title": "Continue in the Brickfact app",
"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": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"market",
"set_id",
"action"
],
"properties": {
"action": {
"enum": [
"price_alert",
"wishlist"
],
"type": "string"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string",
"description": "Retailer market. Required; ask when unknown."
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"language": {
"enum": [
"de",
"en",
"fr",
"nl",
"es",
"it"
],
"type": "string",
"description": "Preferred result language. Comparison-page links always keep the selected retailer market."
},
"target_price": {
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"set_id",
"market",
"currency",
"action",
"target_price",
"created",
"app_url",
"comparison_url",
"steps",
"notes"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"steps": {
"type": "array",
"items": {
"type": "string"
}
},
"action": {
"enum": [
"price_alert",
"wishlist"
],
"type": "string"
},
"market": {
"enum": [
"DE",
"AT",
"CH",
"GB",
"US",
"FR",
"NL",
"ES",
"IT"
],
"type": "string"
},
"set_id": {
"type": "integer",
"maximum": 2147483647,
"minimum": 1
},
"app_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
},
"created": {
"type": "boolean",
"const": false
},
"currency": {
"type": "string"
},
"target_price": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
},
"comparison_url": {
"type": "string",
"pattern": "^https:\\/\\/brickfact\\.com\\/"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}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.
Names, descriptions and schemas were written by the server and are shown as data.