store
Custom metal-print storefront: catalog search, product details, shipping, reviews. Read-only.
¿Debería usar esto?
Calidad y seguridad
A
Hallazgos (1)
- LOWTool 'compare_products' description lacks action verben compare_products
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~12,254Tokens (definiciones de herramientas)
~13.5 KBTamaño de respuesta típico
Impacto significativo en la atención (9.57% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"store": {
"url": "https://bolotstudio.com/api/mcp"
}
}
}Puntos de conexión remotos
https://bolotstudio.com/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (11)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_products(query, handle, country, locale, locale_contract, ...)
Search and browse Bolot Studio custom metal photo prints. Returns a compact product card by default — handle, title, short description, price/compareAtPrice, availability, variants (name/size/price/availability), one image, and the product URL — for every result. For ONE product (pass `handle`), add `detail: true` to also get the AI summary, use cases, FAQs, competitive positioning, social proof, gallery, shipping zones, and guarantee/returns/quality-assurance detail; every response, compact or detailed, is capped to the server's response size limit.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Search term (e.g. 'metal print', 'gift', 'cinematic')",
"type": "string",
"maxLength": 500
},
"handle": {
"description": "Product handle: 'the-legacy-print', 'the-cinematic-print', or 'the-address-sign'",
"type": "string",
"maxLength": 500
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for geo-pricing (e.g. 'PL', 'DE', 'GB', 'DEU', 'GBR')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code for localized URLs (e.g. 'en', 'pl', 'de')",
"type": "string",
"maxLength": 5
},
"locale_contract": {
"description": "Language-resolution contract. Legacy discloses multilingual-country ambiguity; strict requires an explicit locale.",
"type": "string",
"enum": [
"legacy",
"strict"
]
},
"detail": {
"description": "Only used together with `handle` (single-product lookup). When true, returns the full enriched product record — AI summary, use cases, FAQs, competitive positioning, social proof, gallery, shipping zones, guarantee/returns/quality-assurance detail — for that ONE product, still capped to the server's response size limit. Default false returns the compact card shape (handle, title, short description, price, variants, one image, product URL) that every search and every default single-product lookup uses.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"handle": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"compareAtPrice": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"out_of_stock",
"preorder"
]
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
}
},
"featuredImage": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"sku": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"compareAtPrice": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"out_of_stock",
"preorder"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"image": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"dimensions": {
"type": "object",
"properties": {
"width_cm": {
"type": "number"
},
"height_cm": {
"type": "number"
}
},
"required": [
"width_cm",
"height_cm"
],
"additionalProperties": false
}
},
"required": [
"title",
"sku",
"price",
"compareAtPrice",
"availability",
"options",
"image"
],
"additionalProperties": false
}
},
"size_prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"size": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"size",
"amount",
"currency"
],
"additionalProperties": false
}
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"values"
],
"additionalProperties": false
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"productType": {
"type": "string"
},
"vendor": {
"type": "string"
},
"shipping": {
"type": "object",
"properties": {
"freeAbove": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"estimatedDays": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
"zones": {
"type": "array",
"items": {
"type": "string"
}
},
"productionDays": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
}
},
"required": [
"freeAbove",
"estimatedDays",
"zones",
"productionDays"
],
"additionalProperties": false
},
"customization": {
"anyOf": [
{
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"type": {
"type": "string"
},
"description": {
"type": "string"
},
"image_upload": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"formats": {
"type": "array",
"items": {
"type": "string"
}
},
"max_file_size": {
"type": "string"
},
"min_resolution": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
"recommended_resolution": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
}
},
"required": [
"required",
"formats",
"max_file_size",
"min_resolution",
"recommended_resolution"
],
"additionalProperties": false
},
"crop_tool": {
"type": "boolean"
},
"three_d_preview": {
"type": "boolean"
},
"configurator_url": {
"type": "string"
},
"ordering_flow": {
"type": "array",
"items": {
"type": "string"
}
},
"checkout_attribute": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"description": {
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"key",
"description",
"required"
],
"additionalProperties": false
}
},
"required": [
"required",
"type",
"description",
"image_upload",
"crop_tool",
"three_d_preview",
"configurator_url",
"ordering_flow",
"checkout_attribute"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"product_nature": {
"type": "string"
},
"material": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"thickness": {
"type": "string"
},
"process": {
"type": "string"
},
"mounting": {
"type": "string"
}
},
"required": [
"type",
"thickness",
"process",
"mounting"
],
"additionalProperties": false
},
"gifting": {
"type": "object",
"properties": {
"is_giftable": {
"type": "boolean"
},
"gift_wrapping": {
"type": "boolean"
},
"gift_message": {
"type": "boolean"
},
"budget_tiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"variant": {
"type": "string"
},
"from": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"variant",
"from",
"currency"
],
"additionalProperties": false
}
}
},
"required": [
"is_giftable",
"gift_wrapping",
"gift_message",
"budget_tiers"
],
"additionalProperties": false
},
"active_promotions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"qualifying_variants": {
"type": "array",
"items": {
"type": "string"
}
},
"gift_value": {
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"active": {
"type": "boolean"
},
"terms": {
"type": "string"
}
},
"required": [
"id",
"type",
"title",
"description",
"qualifying_variants",
"active"
],
"additionalProperties": false
}
},
"finish_guide": {
"type": "object",
"properties": {
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"best_for": {
"type": "array",
"items": {
"type": "string"
}
},
"avoid_for": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"description",
"best_for",
"avoid_for"
],
"additionalProperties": false
}
},
"decision_rule": {
"type": "string"
}
},
"required": [
"options",
"decision_rule"
],
"additionalProperties": false
},
"b2b": {
"type": "object",
"properties": {
"available": {
"type": "boolean"
},
"programs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"min_order": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"type": "string"
}
},
"required": [
"name",
"min_order",
"description"
],
"additionalProperties": false
}
},
"contact_email": {
"type": "string"
},
"contact_subject": {
"type": "string"
},
"b2b_page_url": {
"type": "string"
},
"vat_invoicing": {
"type": "boolean"
}
},
"required": [
"available",
"programs",
"contact_email",
"contact_subject",
"b2b_page_url",
"vat_invoicing"
],
"additionalProperties": false
},
"launch_gate": {
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "not_available"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
},
"required_compliance_gate": {
"type": "string"
},
"supports_agent_checkout": {
"type": "boolean",
"const": false
},
"checkout_phase": {
"type": "string",
"const": "blocked"
}
},
"required": [
"availability",
"reason",
"message",
"required_compliance_gate",
"supports_agent_checkout",
"checkout_phase"
],
"additionalProperties": false
},
"url": {
"type": "string"
},
"descriptionHtml": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"returns": {
"type": "object",
"properties": {
"days": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"type": {
"type": "string",
"const": "statutory_remedies_personalized_goods"
},
"freeReturns": {
"type": "boolean",
"const": false
},
"changeOfMindReturns": {
"type": "string",
"const": "not_offered_for_personalized_goods"
},
"qualityIssueReportingTiming": {
"type": "string",
"const": "promptly_after_discovery"
},
"qualityIssueReportingHasSeparateDeadline": {
"type": "boolean",
"const": false
},
"merchantPaidVerifiedIssueReturns": {
"type": "boolean",
"const": true
},
"personalizedGoodsExemption": {
"type": "boolean"
},
"legalBasis": {
"type": "string"
},
"process": {
"type": "string"
},
"eligibleReasons": {
"type": "array",
"items": {
"type": "string"
}
},
"excludedReasons": {
"type": "array",
"items": {
"type": "string"
}
},
"coverage": {
"type": "string"
},
"seasonal_override": {
"type": "object",
"properties": {
"period": {
"type": "object",
"properties": {
"start": {
"type": "string"
},
"end": {
"type": "string"
}
},
"required": [
"start",
"end"
],
"additionalProperties": false
},
"days": {
"type": "number"
},
"description": {
"type": "string"
}
},
"required": [
"period",
"days",
"description"
],
"additionalProperties": false
}
},
"required": [
"days",
"type",
"freeReturns",
"changeOfMindReturns",
"qualityIssueReportingTiming",
"qualityIssueReportingHasSeparateDeadline",
"merchantPaidVerifiedIssueReturns"
],
"additionalProperties": false
},
"configuration_contract": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "hosted_configurator_handoff"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"enum",
"string",
"number"
]
},
"required": {
"type": "boolean"
},
"values": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
}
},
"required": [
"id",
"label"
],
"additionalProperties": false
}
},
"max_length": {
"type": "number"
},
"minimum": {
"type": "number"
},
"maximum": {
"type": "number"
},
"default": {
"type": "number"
},
"available_when": {
"type": "object",
"properties": {
"field": {
"type": "string"
},
"equals": {
"type": "string"
}
},
"required": [
"field",
"equals"
],
"additionalProperties": false
}
},
"required": [
"key",
"type",
"required"
],
"additionalProperties": false
}
},
"quote": {
"type": "object",
"properties": {
"basis": {
"type": "string",
"const": "size"
},
"prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"option_id": {
"type": "string"
},
"option_label": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"option_id",
"option_label",
"amount",
"currency"
],
"additionalProperties": false
}
}
},
"required": [
"basis",
"prices"
],
"additionalProperties": false
},
"completion": {
"type": "object",
"properties": {
"agent_checkout_supported": {
"type": "boolean",
"const": false
},
"human_handoff_required": {
"type": "boolean",
"const": true
},
"configurator_url": {
"type": "string"
}
},
"required": [
"agent_checkout_supported",
"human_handoff_required",
"configurator_url"
],
"additionalProperties": false
}
},
"required": [
"mode",
"fields",
"quote",
"completion"
],
"additionalProperties": false
},
"guarantee": {
"type": "object",
"properties": {
"type": {
"type": "string",
"const": "voluntary_commercial_guarantee"
},
"publication_status": {
"type": "string",
"const": "active"
},
"customer_scope": {
"type": "array",
"items": {
"type": "string",
"enum": [
"B2C",
"B2B"
]
}
},
"country_scope": {
"type": "string",
"const": "all_served_countries"
},
"duration_years": {
"type": "number",
"const": 3
},
"starts": {
"type": "string",
"const": "delivery"
},
"coverage": {
"type": "array",
"items": {
"type": "string"
}
},
"remedies": {
"type": "array",
"items": {
"type": "string"
}
},
"accepted_claim_costs": {
"type": "string"
},
"discontinued_exact_material_or_component": {
"type": "string"
},
"performance_timing": {
"type": "string"
},
"mandatory_period_adjustments": {
"type": "string"
},
"reasonable_evidence_may_be_requested": {
"type": "boolean",
"const": true
},
"voluntary_guarantee_exclusions": {
"type": "array",
"items": {
"type": "string"
}
},
"claim_process": {
"type": "string"
},
"retained_image_deletion_effect": {
"type": "string"
},
"mandatory_statutory_rights": {
"type": "string",
"const": "unaffected_under_governing_law"
},
"policy_url": {
"type": "string"
},
"policy_selector": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"url_template": {
"type": "string"
},
"required_inputs": {
"type": "array",
"items": {
"type": "string",
"enum": [
"country",
"locale",
"customerType"
]
}
},
"conditionally_required_inputs": {
"type": "object",
"properties": {
"subdivision": {
"type": "string",
"const": "required_when_country_is_CA"
}
},
"required": [
"subdivision"
],
"additionalProperties": false
},
"inference_policy": {
"type": "string",
"const": "none"
}
},
"required": [
"url",
"url_template",
"required_inputs",
"conditionally_required_inputs",
"inference_policy"
],
"additionalProperties": false
},
"terms_document_count": {
"type": "number"
},
"terms_version": {
"type": "string"
},
"description": {
"type": "string"
}
},
"required": [
"type",
"publication_status",
"customer_scope",
"country_scope",
"duration_years",
"starts",
"coverage",
"remedies",
"accepted_claim_costs",
"discontinued_exact_material_or_component",
"performance_timing",
"mandatory_period_adjustments",
"reasonable_evidence_may_be_requested",
"voluntary_guarantee_exclusions",
"claim_process",
"retained_image_deletion_effect",
"mandatory_statutory_rights",
"policy_url",
"policy_selector",
"terms_document_count",
"terms_version",
"description"
],
"additionalProperties": false
},
"proof_workflow": {
"type": "object",
"properties": {
"applies_when": {
"type": "string",
"const": "bolot_studio_requests_crop_or_correction_approval"
},
"response_period": {
"type": "object",
"properties": {
"maximum_business_days": {
"type": "number",
"const": 5
}
},
"required": [
"maximum_business_days"
],
"additionalProperties": false
},
"no_response_outcome": {
"type": "string",
"const": "produce_using_original_crop_submitted_with_order"
},
"proof_approval_waives_nonconformity_rights": {
"type": "boolean",
"const": false
},
"no_response_waives_nonconformity_rights": {
"type": "boolean",
"const": false
},
"description": {
"type": "string"
}
},
"required": [
"applies_when",
"response_period",
"no_response_outcome",
"proof_approval_waives_nonconformity_rights",
"no_response_waives_nonconformity_rights",
"description"
],
"additionalProperties": false
},
"social_proof": {
"type": "object",
"properties": {
"aggregate_rating": {
"type": "object",
"properties": {
"value": {
"type": "number"
},
"scale": {
"type": "number"
},
"review_count": {
"type": "number"
},
"verified_purchase_count": {
"type": "number"
},
"reviews_with_photos_count": {
"type": "number"
}
},
"required": [
"value",
"scale",
"review_count",
"verified_purchase_count",
"reviews_with_photos_count"
],
"additionalProperties": false
},
"featured_reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"type": "string"
},
"rating": {
"type": "number"
},
"variant": {
"type": "string"
},
"body": {
"type": "string"
},
"verified_purchase": {
"type": "boolean"
},
"has_photo": {
"type": "boolean"
},
"date": {
"type": "string"
}
},
"required": [
"author",
"rating",
"body",
"verified_purchase",
"has_photo",
"date"
],
"additionalProperties": false
}
},
"review_source": {
"type": "string"
},
"review_page_url": {
"type": "string"
}
},
"required": [
"aggregate_rating",
"featured_reviews",
"review_source",
"review_page_url"
],
"additionalProperties": false
},
"use_cases": {
"type": "array",
"items": {
"type": "object",
"properties": {
"occasion": {
"type": "string"
},
"recommended_variant": {
"type": "string"
},
"recommended_finish": {
"type": "string"
},
"price_from": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"why": {
"type": "string"
},
"recipient_profile": {
"type": "string"
},
"age_range": {
"type": "string"
},
"seasonal": {
"type": "boolean"
}
},
"required": [
"occasion",
"recommended_variant",
"recommended_finish",
"price_from",
"why"
],
"additionalProperties": false
}
},
"competitive_positioning": {
"type": "object",
"properties": {
"category": {
"type": "string"
},
"differentiators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"feature": {
"type": "string"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "boolean"
}
]
},
"competitor_typical": {
"anyOf": [
{
"type": "string"
},
{
"type": "boolean"
}
]
}
},
"required": [
"feature",
"value",
"competitor_typical"
],
"additionalProperties": false
}
},
"vs_competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"key_differences": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"key_differences"
],
"additionalProperties": false
}
}
},
"required": [
"category",
"differentiators",
"vs_competitors"
],
"additionalProperties": false
},
"sustainability": {
"type": "object",
"properties": {
"material_recyclability": {
"type": "string"
},
"process_claims": {
"type": "array",
"items": {
"type": "string"
}
},
"packaging": {
"type": "string"
},
"certifications": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"material_recyclability",
"process_claims",
"packaging",
"certifications"
],
"additionalProperties": false
},
"gallery": {
"type": "object",
"properties": {
"product_shots": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"alt": {
"type": "string"
},
"context": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"alt"
],
"additionalProperties": false
}
},
"lifestyle": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"alt": {
"type": "string"
},
"context": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"alt"
],
"additionalProperties": false
}
},
"size_comparison": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"alt": {
"type": "string"
},
"context": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"alt"
],
"additionalProperties": false
}
},
"mounting_detail": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"alt": {
"type": "string"
},
"context": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"alt"
],
"additionalProperties": false
}
},
"close_up": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"alt": {
"type": "string"
},
"context": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"alt"
],
"additionalProperties": false
}
}
},
"required": [
"product_shots",
"lifestyle",
"size_comparison",
"mounting_detail",
"close_up"
],
"additionalProperties": false
},
"quality_assurance": {
"type": "object",
"properties": {
"individual_inspection": {
"type": "boolean"
},
"inspection_description": {
"type": "string"
},
"color_accuracy": {
"type": "string"
},
"production_method": {
"type": "string"
},
"quality_standard": {
"type": "string"
},
"defect_policy": {
"type": "string"
}
},
"required": [
"individual_inspection",
"inspection_description",
"color_accuracy",
"production_method",
"quality_standard"
],
"additionalProperties": false
},
"localized_urls": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"available_locales": {
"type": "array",
"items": {
"type": "string"
}
},
"ai_summary": {
"type": "object",
"properties": {
"one_liner": {
"type": "string"
},
"key_differentiator": {
"type": "string"
},
"ideal_for": {
"type": "array",
"items": {
"type": "string"
}
},
"not_ideal_for": {
"type": "array",
"items": {
"type": "string"
}
},
"decision_factors": {
"type": "array",
"items": {
"type": "string"
}
},
"requires_photo_upload": {
"type": "boolean"
},
"has_3d_preview": {
"type": "boolean"
},
"has_template_editor": {
"type": "boolean"
},
"production_timeline": {
"type": "object",
"properties": {
"min_days": {
"type": "number"
},
"max_days": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"min_days",
"max_days",
"note"
],
"additionalProperties": false
},
"price_breakdown": {
"type": "array",
"items": {
"type": "object",
"properties": {
"variant": {
"type": "string"
},
"from": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"variant",
"from",
"currency"
],
"additionalProperties": false
}
},
"unique_benefits": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"one_liner",
"key_differentiator",
"ideal_for",
"not_ideal_for",
"decision_factors",
"requires_photo_upload",
"has_3d_preview",
"has_template_editor"
],
"additionalProperties": false
},
"ai_description": {
"type": "string"
},
"faqs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
}
},
"product_comparison": {
"type": "object",
"properties": {
"vs_product": {
"type": "string"
},
"vs_product_title": {
"type": "string"
},
"differences": {
"type": "array",
"items": {
"type": "string"
}
},
"when_to_choose_this": {
"type": "array",
"items": {
"type": "string"
}
},
"when_to_choose_other": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"vs_product",
"vs_product_title",
"differences",
"when_to_choose_this",
"when_to_choose_other"
],
"additionalProperties": false
},
"shipping_zones": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zone": {
"type": "string"
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"delivery_days": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
"carrier": {
"type": "string"
}
},
"required": [
"zone",
"countries",
"delivery_days"
],
"additionalProperties": false
}
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"compareAtPrice": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"out_of_stock",
"preorder"
]
},
"images": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
}
},
"featuredImage": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"variants": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"sku": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"price": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"compareAtPrice": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"availability": {
"type": "string",
"enum": [
"in_stock",
"out_of_stock",
"preorder"
]
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"value": {
"type": "string"
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"image": {
"anyOf": [
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"altText": {
"type": "string"
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"url",
"altText",
"width",
"height"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"dimensions": {
"type": "object",
"properties": {
"width_cm": {
"type": "number"
},
"height_cm": {
"type": "number"
}
},
"required": [
"width_cm",
"height_cm"
],
"additionalProperties": false
}
},
"required": [
"title",
"sku",
"price",
"compareAtPrice",
"availability",
"options",
"image"
],
"additionalProperties": false
}
},
"size_prices": {
"type": "array",
"items": {
"type": "object",
"properties": {
"size": {
"type": "string"
},
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"size",
"amount",
"currency"
],
"additionalProperties": false
}
},
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"values"
],
"additionalProperties": false
}
},
"tags": {
"type": "array",
"items": {
"type": "string"
}
},
"productType": {
"type": "string"
},
"vendor": {
"type": "string"
},
"shipping": {
"type": "object",
"properties": {
"freeAbove": {
"anyOf": [
{
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"estimatedDays": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
},
"zones": {
"type": "array",
"items": {
"type": "string"
}
},
"productionDays": {
"type": "object",
"properties": {
"min": {
"type": "number"
},
"max": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"additionalProperties": false
}
},
"required": [
"freeAbove",
"estimatedDays",
"zones",
"productionDays"
],
"additionalProperties": false
},
"customization": {
"anyOf": [
{
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"type": {
"type": "string"
},
"description": {
"type": "string"
},
"image_upload": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
},
"formats": {
"type": "array",
"items": {
"type": "string"
}
},
"max_file_size": {
"type": "string"
},
"min_resolution": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
},
"recommended_resolution": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
}
},
"required": [
"required",
"formats",
"max_file_size",
"min_resolution",
"recommended_resolution"
],
"additionalProperties": false
},
"crop_tool": {
"type": "boolean"
},
"three_d_preview": {
"type": "boolean"
},
"configurator_url": {
"type": "string"
},
"ordering_flow": {
"type": "array",
"items": {
"type": "string"
}
},
"checkout_attribute": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"description": {
"type": "string"
},
"required": {
"type": "boolean"
}
},
"required": [
"key",
"description",
"required"
],
"additionalProperties": false
}
},
"required": [
"required",
"type",
"description",
"image_upload",
"crop_tool",
"three_d_preview",
"configurator_url",
"ordering_flow",
"checkout_attribute"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"product_nature": {
"type": "string"
},
"material": {
"type": "object",
"properties": {
"type": {
"type": "string"
},
"thickness": {
"type": "string"
},
"process": {
"type": "string"
},
"mounting": {
"type": "string"
}
},
"required": [
"type",
"thickness",
"process",
"mounting"
],
"additionalProperties": false
},
"gifting": {
"type": "object",
"properties": {
"is_giftable": {
"type": "boolean"
},
"gift_wrapping": {
"type": "boolean"
},
"gift_message": {
"type": "boolean"
},
"budget_tiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"variant": {
"type": "string"
},
"from": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"label",
"variant",
"from",
"currency"
],
"additionalProperties": false
}
}
},
"required": [
"is_giftable",
"gift_wrapping",
"gift_message",
"budget_tiers"
],
"additionalProperties": false
},
"active_promotions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"type": {
"type": "string"
},
"title": {
"type": "string"
},
"description": {
"type": "string"
},
"qualifying_variants": {
"type": "array",
"items": {
"type": "string"
}
},
"gift_value": {
"type": "object",
"properties": {
"amount": {
"type": "string"
},
"currency": {
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"additionalProperties": false
},
"active": {
"type": "boolean"
},
"terms": {
"type": "string"
}
},
"required": [
"id",
"type",
"title",
"description",
"qualifying_variants",
"active"
],
"additionalProperties": false
}
},
"finish_guide": {
"type": "object",
"properties": {
"options": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
},
"best_for": {
"type": "array",
"items": {
"type": "string"
}
},
"avoid_for": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"description",
"best_for",
"avoid_for"
],
"additionalProperties": false
}
},
"decision_rule": {
"type": "string"
}
},
"required": [
"options",
"decision_rule"
],
"additionalProperties": false
},
"b2b": {
"type": "object",
"properties": {
"available": {
"type": "boolean"
},
"programs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"min_order": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"description": {
"type": "string"
}
},
"required": [
"name",
"min_order",
"description"
],
"additionalProperties": false
}
},
"contact_email": {
"type": "string"
},
"contact_subject": {
"type": "string"
},
"b2b_page_url": {
"type": "string"
},
"vat_invoicing": {
"type": "boolean"
}
},
"required": [
"available",
"programs",
"contact_email",
"contact_subject",
"b2b_page_url",
"vat_invoicing"
],
"additionalProperties": false
},
"launch_gate": {
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "not_available"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
},
"required_compliance_gate": {
"type": "string"
},
"supports_agent_checkout": {
"type": "boolean",
"const": false
},
"checkout_phase": {
"type": "string",
"const": "blocked"
}
},
"required": [
"availability",
"reason",
"message",
"required_compliance_gate",
"supports_agent_checkout",
"checkout_phase"
],
"additionalProperties": false
},
"url": {
"type": "string"
}
},
"required": [
"handle",
"title",
"description",
"price",
"compareAtPrice",
"availability",
"images",
"featuredImage",
"variants",
"size_prices",
"options",
"tags",
"productType",
"vendor",
"shipping",
"customization",
"product_nature",
"material",
"url"
],
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"market": {
"type": "string"
},
"product": {
"type": "string"
},
"wall_art_launch_gate": {
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "not_available"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
},
"required_compliance_gate": {
"type": "string"
},
"supports_agent_checkout": {
"type": "boolean",
"const": false
},
"checkout_phase": {
"type": "string",
"const": "blocked"
}
},
"required": [
"availability",
"reason",
"message",
"required_compliance_gate",
"supports_agent_checkout",
"checkout_phase"
],
"additionalProperties": false
},
"address_sign_launch_gate": {
"type": "object",
"properties": {
"availability": {
"type": "string",
"const": "not_available"
},
"reason": {
"type": "string"
},
"message": {
"type": "string"
},
"required_compliance_gate": {
"type": "string"
},
"supports_agent_checkout": {
"type": "boolean",
"const": false
},
"checkout_phase": {
"type": "string",
"const": "blocked"
}
},
"required": [
"availability",
"reason",
"message",
"required_compliance_gate",
"supports_agent_checkout",
"checkout_phase"
],
"additionalProperties": false
},
"available_handles": {
"type": "array",
"items": {
"type": "string"
}
},
"supported_locales": {
"type": "array",
"items": {
"type": "string"
}
},
"language_ambiguity": {
"type": "object",
"properties": {
"country": {
"type": "string",
"const": "CH"
},
"default_locale": {
"type": "string",
"const": "de"
},
"supported_locales": {
"type": "array",
"items": {
"type": "string",
"enum": [
"de",
"fr",
"it"
]
}
},
"deprecation": {
"type": "string",
"const": "locale_will_be_required"
}
},
"required": [
"country",
"default_locale",
"supported_locales",
"deprecation"
],
"additionalProperties": false
},
"tool": {
"type": "string"
},
"reason": {
"type": "string"
},
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_product_recommendations(intent, budget, recipient_profile, room_type, lighting, ...)
Get personalized product and variant recommendations based on customer intent, budget, recipient profile, room type, and lighting conditions.
Esquema de entrada
{
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Customer intent: gift, home_decor, valentines, birthday_50, memorial, desk_display, home_cinema, etc."
},
"budget": {
"description": "Maximum budget in EUR",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000
},
"recipient_profile": {
"description": "Who is this for: partner, mother, father, man_who_has_everything, woman, couple, pet_lover, photographer, movie_fan",
"type": "string",
"maxLength": 500
},
"room_type": {
"description": "Room type: living_room, bedroom, office, bathroom, kitchen, entertainment_room",
"type": "string",
"maxLength": 500
},
"lighting": {
"description": "Room lighting: bright, dim, mixed",
"type": "string",
"maxLength": 500
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for geo-pricing (e.g. 'PL', 'DE', 'GB', 'DEU', 'GBR')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code for localized URLs (e.g. 'en', 'pl', 'de')",
"type": "string",
"maxLength": 5
}
},
"required": [
"intent"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"recommendations": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"total_matches": {
"type": "number"
},
"finish_advice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"room_advice": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"active_promotions": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"wall_art_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"address_sign_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"note": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_policies_and_faqs(query, country, locale)
Search Bolot Studio FAQs and store policies. Covers product questions, sizing, finishes, shipping, returns, and ordering.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"type": "string",
"maxLength": 500,
"description": "Search query (e.g. 'returns', 'shipping to Germany', 'matte vs glossy', 'desk stand')"
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for locale-aware policy URLs (e.g. 'PL', 'DE', 'GB', 'DEU', 'GBR')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code for localized policy URLs (e.g. 'en', 'pl', 'de')",
"type": "string",
"maxLength": 5
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"faqs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"faq_page",
"product_faq",
"guarantee"
]
},
"locale": {
"type": "string"
},
"question": {
"type": "string"
},
"answer": {
"type": "string"
}
},
"required": [
"question",
"answer"
],
"additionalProperties": false
}
},
"total_matches": {
"type": "number"
},
"returned_matches": {
"type": "number"
},
"locale": {
"type": "string"
},
"locale_fallback": {
"type": "boolean"
},
"policy_links": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"shipping_by_country": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢compare_products(comparison_type, product_handle, country, locale)
Compare Bolot Studio products — Legacy Print vs Cinematic Print, or Bolot vs competitors (Displate, Canvas, Framed prints).
Esquema de entrada
{
"type": "object",
"properties": {
"comparison_type": {
"type": "string",
"enum": [
"legacy_vs_cinematic",
"vs_competitors"
],
"description": "Type of comparison"
},
"product_handle": {
"description": "Product handle for competitor comparison (defaults to 'the-legacy-print')",
"type": "string",
"maxLength": 500
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for localized URLs (e.g. 'PL', 'DE', 'GB', 'DEU', 'GBR')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code for localized URLs (e.g. 'en', 'pl', 'de')",
"type": "string",
"maxLength": 5
}
},
"required": [
"comparison_type"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"comparison": {
"type": "string"
},
"legacy_print": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"cinematic_print": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"shared_features": {
"type": "array",
"items": {
"type": "string"
}
},
"product": {
"type": "string"
},
"category": {
"type": "string"
},
"differentiators": {
"type": "array",
"items": {
"type": "object",
"properties": {
"feature": {
"type": "string"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "boolean"
}
]
},
"competitor_typical": {
"anyOf": [
{
"type": "string"
},
{
"type": "boolean"
}
]
}
},
"required": [
"feature",
"value",
"competitor_typical"
],
"additionalProperties": false
}
},
"vs_competitors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"key_differences": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"key_differences"
],
"additionalProperties": false
}
},
"quality_assurance": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sustainability": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"message": {
"type": "string"
},
"market": {
"type": "string"
},
"wall_art_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_store_info(country, locale)
Get Bolot Studio brand information, shipping zones, payment methods, and configurator URLs. Essential context for helping customers.
Esquema de entrada
{
"type": "object",
"properties": {
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for market-visible catalog sizes/prices (e.g. 'DE', 'DEU')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code used when country is not supplied",
"type": "string",
"maxLength": 5
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"brand": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"market": {
"type": "string"
},
"products": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"agent_instructions": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"configurator_urls": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"shipping_by_country": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"payment_methods": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"free_shipping": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"active_promotions": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
},
"b2b": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"finish_guide": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"quality_assurance": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"sustainability": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"policy_urls": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"wall_art_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"address_sign_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"error": {
"type": "string"
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢check_photo_compatibility(width, height, format, country)
Check whether supplied pixel dimensions meet the print-contract 120 DPI hard gate used by upload. Returns per-size required_px. Crop and artefacts are still reviewed in the configurator. With a delivery country, also lists market-visible wall formats. If width/height are omitted, reports that suitability cannot be verified without dimensions.
Esquema de entrada
{
"type": "object",
"properties": {
"width": {
"description": "Photo width in pixels",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 30000
},
"height": {
"description": "Photo height in pixels",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 30000
},
"format": {
"description": "Image format (e.g. 'jpeg', 'png', 'heic', 'webp')",
"type": "string",
"maxLength": 500
},
"country": {
"description": "Delivery country as ISO alpha-2 or alpha-3. Required before market-visible print formats can be shown.",
"type": "string",
"maxLength": 3
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"photo": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"format": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"megapixels": {
"type": "number"
}
},
"required": [
"width",
"height",
"format",
"megapixels"
],
"additionalProperties": false
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"market": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"assessment_status": {
"type": "string",
"enum": [
"destination_required",
"dimensions_required",
"requires_configurator_review",
"product_unavailable",
"incompatible",
"too_large"
]
},
"resolution_status": {
"type": "string",
"enum": [
"compatible",
"incompatible",
"mixed",
"too_large",
"unknown"
]
},
"resolution_by_size": {
"type": "array",
"items": {
"type": "object",
"properties": {
"size": {
"type": "string"
},
"orientation": {
"type": "string",
"enum": [
"landscape",
"portrait"
]
},
"status": {
"type": "string",
"enum": [
"ok",
"warn",
"fail"
]
},
"required_px": {
"type": "object",
"properties": {
"w": {
"type": "number"
},
"h": {
"type": "number"
}
},
"required": [
"w",
"h"
],
"additionalProperties": false
},
"recommended_px": {
"type": "object",
"properties": {
"w": {
"type": "number"
},
"h": {
"type": "number"
}
},
"required": [
"w",
"h"
],
"additionalProperties": false
}
},
"required": [
"size",
"orientation",
"status",
"required_px",
"recommended_px"
],
"additionalProperties": false
}
},
"available_print_formats": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product": {
"type": "string"
},
"size": {
"type": "string"
},
"label": {
"type": "string"
},
"dimensions_cm": {
"type": "string"
},
"technical_size": {
"type": "string"
},
"resolution": {
"type": "string",
"enum": [
"ok",
"warn",
"fail"
]
},
"required_px": {
"type": "object",
"properties": {
"landscape": {
"type": "object",
"properties": {
"w": {
"type": "number"
},
"h": {
"type": "number"
}
},
"required": [
"w",
"h"
],
"additionalProperties": false
},
"portrait": {
"type": "object",
"properties": {
"w": {
"type": "number"
},
"h": {
"type": "number"
}
},
"required": [
"w",
"h"
],
"additionalProperties": false
}
},
"required": [
"landscape",
"portrait"
],
"additionalProperties": false
}
},
"required": [
"product",
"size",
"label",
"dimensions_cm"
],
"additionalProperties": false
}
},
"recommended_format": {
"type": "null"
},
"compatibility_determined": {
"type": "boolean"
},
"review_factors": {
"type": "array",
"items": {
"type": "string"
}
},
"supported_upload_formats": {
"type": "array",
"items": {
"type": "string"
}
},
"launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"recommendation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"format_note": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"configurator_note": {
"type": "string"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_shipping_estimate(country_code)
Get estimated delivery time, free shipping threshold, and carrier information for a specific country. Use this when a customer asks about shipping costs or delivery times to their location.
Esquema de entrada
{
"type": "object",
"properties": {
"country_code": {
"type": "string",
"minLength": 2,
"maxLength": 3,
"description": "ISO 3166-1 alpha-2 or alpha-3 country code (e.g. 'PL', 'DE', 'GB', 'FR', 'DEU', 'GBR')"
}
},
"required": [
"country_code"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"country_code": {
"type": "string"
},
"supported": {
"type": "boolean"
},
"delivery_estimate": {
"type": "string"
},
"free_shipping": {
"type": "string"
},
"carrier": {
"type": "string"
},
"shipping_cost": {
"type": "object",
"properties": {
"flat_amount_minor": {
"type": "number"
},
"free_threshold_minor": {
"type": "number"
},
"currency": {
"type": "string"
}
},
"required": [
"flat_amount_minor",
"free_threshold_minor",
"currency"
],
"additionalProperties": false
},
"tax_duty_handling_setup_dependent": {
"type": "boolean"
},
"tax_duty_handling_note": {
"type": "string"
},
"wall_art_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"address_sign_launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"manufacturing_note": {
"type": "string"
},
"total_estimated_time": {
"type": "string"
},
"tracking": {
"type": "string"
},
"returns": {
"type": "string"
},
"message": {
"type": "string"
},
"supported_countries": {
"type": "array",
"items": {
"type": "string"
}
},
"error": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢get_reviews_summary(product_handle)
Get aggregated customer review statistics and featured review excerpts. Use this when a customer asks about product quality, other customers' experiences, or social proof. Returns ratings, distribution, and highlighted reviews.
Esquema de entrada
{
"type": "object",
"properties": {
"product_handle": {
"description": "Product handle: 'the-legacy-print', 'the-cinematic-print', or 'the-address-sign'. Omit for store-wide stats.",
"type": "string",
"maxLength": 500
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"source": {
"type": "string"
},
"scope": {
"type": "string"
},
"average_rating": {
"type": "number"
},
"total_reviews": {
"type": "number"
},
"verified_purchase_count": {
"type": "number"
},
"featured_reviews": {
"type": "array",
"items": {
"type": "object",
"properties": {
"author": {
"type": "string"
},
"rating": {
"type": "number"
},
"excerpt": {
"type": "string"
},
"verified": {
"type": "boolean"
}
},
"required": [
"author",
"rating",
"excerpt",
"verified"
],
"additionalProperties": false
}
},
"review_platform": {
"type": "string"
},
"note": {
"type": "string"
},
"available": {
"type": "boolean"
},
"error": {
"type": "string"
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢start_configuration(product_handle, country, locale, size, finish)
Generate a direct URL to the Bolot Studio product configurator with pre-selected options. Optionally pre-select size and/or finish ('matte' or 'glossy'). Valid sizes are product-specific: 'the-legacy-print' accepts 'keepsake-3-pack' (three separate 13×9 cm panels with three separate metal desk stands), 'classic' (30×20), or 'statement' (42×30); 'the-cinematic-print' accepts 'intimate' (21×14), 'classic' (30×20), or 'statement' (42×30); 'the-address-sign' uses templates and ignores size/finish.
Esquema de entrada
{
"type": "object",
"properties": {
"product_handle": {
"type": "string",
"enum": [
"the-legacy-print",
"the-cinematic-print",
"the-address-sign"
],
"description": "Product to configure"
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for market-visible product availability (e.g. 'DE', 'DEU')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code (en, de, pl, etc.)",
"type": "string",
"maxLength": 500
},
"size": {
"description": "Pre-select size. Valid set depends on the product: 'the-legacy-print' → 'keepsake-3-pack', 'classic', or 'statement'; 'the-cinematic-print' → 'intimate', 'classic', or 'statement'. The retired single token 'keepsake' is never accepted.",
"type": "string",
"enum": [
"keepsake-3-pack",
"classic",
"statement",
"intimate"
]
},
"finish": {
"description": "Pre-select finish. Not applicable to address sign.",
"type": "string",
"enum": [
"matte",
"glossy"
]
}
},
"required": [
"product_handle"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"_response_budget": {
"type": "object",
"properties": {
"dropped": {
"type": "array",
"items": {
"type": "string"
}
},
"limit_bytes": {
"type": "number"
},
"note": {
"type": "string"
}
},
"required": [
"dropped",
"limit_bytes",
"note"
],
"additionalProperties": false
},
"configurator_url": {
"type": "string"
},
"product": {
"type": "string"
},
"locale": {
"type": "string"
},
"pre_selected": {
"type": "object",
"properties": {
"size": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"size",
"finish"
],
"additionalProperties": false
},
"instructions": {
"type": "string"
},
"note": {
"type": "string"
},
"error": {
"type": "string"
},
"market": {
"type": "string"
},
"launch_gate": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"requested_size": {
"type": "string"
},
"valid_sizes": {
"type": "array",
"items": {
"type": "string"
}
},
"message": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}🟢search_products_task(query, handle, country, locale, locale_contract, ...)
Task-based product search for long-running MCP clients. Use task polling to retrieve the result.
Esquema de entrada
{
"type": "object",
"properties": {
"query": {
"description": "Search term (e.g. 'metal print', 'gift', 'cinematic')",
"type": "string",
"maxLength": 500
},
"handle": {
"description": "Product handle: 'the-legacy-print', 'the-cinematic-print', or 'the-address-sign'",
"type": "string",
"maxLength": 500
},
"country": {
"description": "ISO 3166-1 alpha-2 or alpha-3 country code for geo-pricing (e.g. 'PL', 'DE', 'GB', 'DEU', 'GBR')",
"type": "string",
"maxLength": 3
},
"locale": {
"description": "Locale code for localized URLs (e.g. 'en', 'pl', 'de')",
"type": "string",
"maxLength": 5
},
"locale_contract": {
"description": "Language-resolution contract. Legacy discloses multilingual-country ambiguity; strict requires an explicit locale.",
"type": "string",
"enum": [
"legacy",
"strict"
]
},
"detail": {
"description": "Only used together with `handle` (single-product lookup). When true, returns the full enriched product record — AI summary, use cases, FAQs, competitive positioning, social proof, gallery, shipping zones, guarantee/returns/quality-assurance detail — for that ONE product, still capped to the server's response size limit. Default false returns the compact card shape (handle, title, short description, price, variants, one image, product URL) that every search and every default single-product lookup uses.",
"type": "boolean"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢check_photo_compatibility_task(width, height, format, country)
Task-based photo-resolution check against the print-contract 120 DPI hard gate used by upload. Omit width/height to report that suitability cannot be verified without dimensions.
Esquema de entrada
{
"type": "object",
"properties": {
"width": {
"description": "Photo width in pixels",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 30000
},
"height": {
"description": "Photo height in pixels",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 30000
},
"format": {
"description": "Image format (e.g. 'jpeg', 'png', 'heic', 'webp')",
"type": "string",
"maxLength": 500
},
"country": {
"description": "Delivery country as ISO alpha-2 or alpha-3. Required before market-visible print formats can be shown.",
"type": "string",
"maxLength": 3
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada11 herramientas
verificadoversión no registrada11 herramientas