{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "shop.customblinds.co.za",
    "site": "customblinds.co.za",
    "addresses": [
      {
        "address": "172.67.206.39",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.192.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.90.233",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/19",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3037::6815:5ae9",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3037::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3031::ac43:ce27",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3031::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.206.39",
          "104.21.90.233",
          "2606:4700:3037::6815:5ae9",
          "2606:4700:3031::ac43:ce27"
        ],
        "first_seen": "2026-11-22T18:29:02.258Z",
        "last_seen": "2026-11-22T18:29:02.258Z",
        "checks": 1
      },
      {
        "addresses": [
          "172.67.206.39",
          "104.21.90.233",
          "2606:4700:3031::ac43:ce27",
          "2606:4700:3037::6815:5ae9"
        ],
        "first_seen": "2026-11-21T13:48:01.513Z",
        "last_seen": "2026-11-21T13:48:01.513Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "custom-blinds-shop",
      "version": "2.0.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=31536000",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.CustomBlinds",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/CustomBlinds/cb-shop-mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "24098",
    "server_name": "io.github.CustomBlinds/cb-shop",
    "url": "https://shop.customblinds.co.za/mcp",
    "host": "shop.customblinds.co.za",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T18:29:02.258Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "2687eea09090e311a01343e6afa2bd01f50d9766111dddc9666e76c8410abaef",
    "first_listed_at": "2026-11-21T13:48:01.513Z",
    "created_at": "2026-11-21T08:15:07.865Z",
    "resolved_addresses": [
      "172.67.206.39",
      "104.21.90.233",
      "2606:4700:3037::6815:5ae9",
      "2606:4700:3031::ac43:ce27"
    ]
  },
  "server": {
    "name": "io.github.CustomBlinds/cb-shop",
    "title": "Custom Blinds Shop",
    "description": "South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.",
    "version": "1.0.0",
    "registry_status": "active",
    "repository_url": "https://github.com/CustomBlinds/cb-shop-mcp",
    "website_url": null,
    "published_at": "2026-05-28T08:19:05.012Z",
    "updated_at": "2026-05-28T08:19:05.012Z",
    "first_seen": "2026-11-21T08:15:07.194Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T18:29:07.064Z"
  },
  "operator": {
    "key": "customblinds.co.za",
    "name": "customblinds.co.za",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 449,
    "first_check_in_window": "2026-11-21T13:48:01.513Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "2687eea09090e311a01343e6afa2bd01f50d9766111dddc9666e76c8410abaef",
    "tools": 27,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-22T18:29:02.726Z",
    "tool_names": [
      "validate_measurement",
      "get_price",
      "configure_product",
      "search_catalog",
      "lookup_catalog",
      "get_product",
      "create_quote_link",
      "create_cart",
      "get_cart",
      "update_cart",
      "cancel_cart",
      "create_checkout",
      "get_checkout",
      "update_checkout",
      "complete_checkout",
      "cancel_checkout",
      "get_order",
      "check_colour_stock",
      "request_swatch",
      "get_payment_methods",
      "get_whatsapp_handoff",
      "get_product_recommendation",
      "get_ar_visualizer_url",
      "start_visualiser_preview",
      "get_visualiser_preview",
      "get_delivery_estimate",
      "request_price_match"
    ],
    "declared": {
      "tools": [
        {
          "name": "validate_measurement",
          "title": "Check blind measurements",
          "description": "Check a customer's sizes before pricing. Returns ok, problems (must fix), warnings (ask the customer) and advice: size limits for the product, product minimums, centimetre slips, inside-mount reveal depth (single rollers 50mm, no-drill rollers included; Double Roller zebra 80mm; Duo Roller 115mm), no-drill rules (inside only, at least 50mm reveal on rollers and 40mm on 25mm venetians, 2000mm max width, 1500mm on 25mm venetians), face-fix sizing (add 100mm each side and 100mm above and below) and the width we deduct when making an inside mount. Changes nothing and returns no price.",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm"
            ],
            "properties": {
              "colour": {
                "type": "string",
                "description": "Optional exact colour name, checked for stock and width limits"
              },
              "no_drill": {
                "type": "boolean",
                "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
              },
              "width_mm": {
                "type": "number",
                "description": "Width the customer will enter, in millimetres"
              },
              "height_mm": {
                "type": "number",
                "description": "Drop the customer will enter, in millimetres"
              },
              "mount_type": {
                "type": "string",
                "description": "inside (in the recess) or outside mount"
              },
              "product_id": {
                "type": "string",
                "description": "product_id from search_catalog or lookup_catalog"
              },
              "opening_drop_mm": {
                "type": "number",
                "description": "Optional, outside mount only: drop of the opening itself"
              },
              "reveal_depth_mm": {
                "type": "number",
                "description": "Optional depth of the recess in mm, needed for inside mounts and no-drill"
              },
              "opening_width_mm": {
                "type": "number",
                "description": "Optional, outside mount only: width of the opening itself"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm",
              "ok",
              "problems",
              "warnings",
              "advice",
              "measure_guide_url",
              "next_step"
            ],
            "properties": {
              "ok": {
                "type": "boolean"
              },
              "advice": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "limits": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [],
                    "properties": {},
                    "additionalProperties": true
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "no_drill": {
                "type": "boolean"
              },
              "problems": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "warnings": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "width_mm": {
                "type": "number"
              },
              "height_mm": {
                "type": "number"
              },
              "next_step": {
                "type": "string"
              },
              "mount_type": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "product_id": {
                "type": "string"
              },
              "product_name": {
                "type": "string"
              },
              "reveal_depth_mm": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "measure_guide_url": {
                "type": "string"
              },
              "production_width_mm": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "inside_mount_min_reveal_mm": {
                "type": "number"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Check blind measurements",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_price",
          "title": "Get price for a size",
          "description": "Get an exact ZAR price using product_id from search_catalog or lookup_catalog, width_mm and height_mm. Prices include VAT and delivery. Colour selects the bamboo price tier where applicable. A price is not a stock reservation: validate the exact colour and mount with configure_product before creating a cart. Failure can return success:false or a JSON-RPC validation error.",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm"
            ],
            "properties": {
              "colour": {
                "type": "string",
                "description": "Optional bamboo colour for colour-specific tier pricing"
              },
              "finish": {
                "type": "string",
                "description": "Optional finish for aluminium products: Plain, Brushed, Woodgrain"
              },
              "no_drill": {
                "type": "boolean",
                "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
              },
              "province": {
                "type": "string",
                "description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."
              },
              "quantity": {
                "type": "number",
                "description": "Number of blinds (default 1)"
              },
              "width_mm": {
                "type": "number",
                "description": "Width in millimetres (e.g. 1200)"
              },
              "height_mm": {
                "type": "number",
                "description": "Height/drop in millimetres (e.g. 1500)"
              },
              "product_id": {
                "type": "string",
                "description": "product_id from search_catalog or lookup_catalog (e.g. roller-blockout)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm",
              "quantity",
              "unit_price_zar",
              "total_price_zar",
              "currency",
              "vat_included"
            ],
            "properties": {
              "finish": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "limits": {
                "type": "object",
                "required": [],
                "properties": {},
                "additionalProperties": true
              },
              "contact": {
                "type": "object",
                "required": [],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "whatsapp": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "delivery": {
                "type": "string"
              },
              "quantity": {
                "type": "number"
              },
              "width_mm": {
                "type": "number"
              },
              "height_mm": {
                "type": "number"
              },
              "lead_time": {
                "type": "string"
              },
              "next_step": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "product_name": {
                "type": "string"
              },
              "vat_included": {
                "type": "boolean"
              },
              "unit_price_zar": {
                "type": "number"
              },
              "total_price_zar": {
                "type": "number"
              },
              "effective_width_mm": {
                "type": "number"
              },
              "effective_height_mm": {
                "type": "number"
              },
              "minimum_charge_applied": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Get price for a size",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "configure_product",
          "title": "Configure a blind",
          "description": "Lock in a full blind specification: product, dimensions, colour, and mount type (inside recess or outside face-fix). Validates that the colour exists and is in stock, then prices the blind. Returns a configuration summary to pass directly into create_cart. Call check_colour_stock first if availability is uncertain. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm",
              "colour",
              "mount_type"
            ],
            "properties": {
              "colour": {
                "type": "string",
                "description": "Colour name (must match available colours)"
              },
              "finish": {
                "type": "string",
                "description": "Optional finish for aluminium venetians"
              },
              "no_drill": {
                "type": "boolean",
                "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
              },
              "province": {
                "type": "string",
                "description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."
              },
              "quantity": {
                "type": "number",
                "description": "Number of blinds (default 1)"
              },
              "width_mm": {
                "type": "number",
                "description": "Width in millimetres"
              },
              "height_mm": {
                "type": "number",
                "description": "Height/drop in millimetres"
              },
              "mount_type": {
                "type": "string",
                "minLength": 1,
                "description": "Use inside (recess) or outside (face-fix); handler requires a nonempty value"
              },
              "product_id": {
                "type": "string",
                "description": "product_id from search_catalog or lookup_catalog"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "width_mm",
              "height_mm",
              "colour",
              "mount_type",
              "quantity",
              "unit_price_zar",
              "total_price_zar",
              "currency"
            ],
            "properties": {
              "colour": {
                "type": "string"
              },
              "finish": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "limits": {
                "type": "object",
                "required": [],
                "properties": {},
                "additionalProperties": true
              },
              "contact": {
                "type": "object",
                "required": [],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "whatsapp": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "summary": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "delivery": {
                "type": "string"
              },
              "in_stock": {
                "type": "boolean"
              },
              "quantity": {
                "type": "number"
              },
              "width_mm": {
                "type": "number"
              },
              "height_mm": {
                "type": "number"
              },
              "lead_time": {
                "type": "string"
              },
              "next_step": {
                "type": "string"
              },
              "price_zar": {
                "type": "number"
              },
              "mount_type": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "product_name": {
                "type": "string"
              },
              "vat_included": {
                "type": "boolean"
              },
              "unit_price_zar": {
                "type": "number"
              },
              "total_price_zar": {
                "type": "number"
              },
              "effective_width_mm": {
                "type": "number"
              },
              "effective_height_mm": {
                "type": "number"
              },
              "minimum_charge_applied": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Configure a blind",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "search_catalog",
          "title": "Search the blinds catalogue",
          "description": "Preferred free-text discovery. Returns results containing product_id, name, category, description, product_url and colour_count_in_stock, plus total and currency. For structured filters use lookup_catalog. Pass product_id to get_product or get_price.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "query": {
                "type": "string",
                "description": "Free-text query, e.g. 'blockout' or 'venetian'"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "results",
              "total",
              "currency"
            ],
            "properties": {
              "total": {
                "type": "number"
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "name",
                    "category",
                    "description",
                    "product_url",
                    "colour_count_in_stock"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "category": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "product_url": {
                      "type": "string"
                    },
                    "colour_count_in_stock": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Search the blinds catalogue",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "lookup_catalog",
          "title": "Filter the catalogue",
          "description": "Preferred structured discovery. Filter by category, partial colour name or required supported width/drop in mm. Returns results containing product_id, name, category and product_url, plus total. Width/drop filters check separate maximums, not every combination; confirm the exact pair with get_price.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "colour": {
                "type": "string"
              },
              "category": {
                "type": "string",
                "description": "roller | venetian | honeycomb | vertical | outdoor"
              },
              "max_width_mm": {
                "type": "number"
              },
              "max_height_mm": {
                "type": "number"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "results",
              "total"
            ],
            "properties": {
              "total": {
                "type": "number"
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "name",
                    "category",
                    "product_url"
                  ],
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "category": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "product_url": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Filter the catalogue",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_product",
          "title": "Get product details",
          "description": "Fetch complete details for one product by id (e.g. roller-blockout, venetian-25mm-aluwood). Returns all available colours with in-stock status, materials, features, and maximum supported dimensions. Use before configure_product to confirm a colour exists and is in stock before committing. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id"
            ],
            "properties": {
              "product_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "name",
              "category",
              "colours",
              "product_url"
            ],
            "properties": {
              "name": {
                "type": "string"
              },
              "colours": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "in_stock"
                  ],
                  "properties": {
                    "hex": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "finish": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "in_stock": {
                      "type": "boolean"
                    },
                    "material": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "expected_restock": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              },
              "category": {
                "type": "string"
              },
              "features": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "materials": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "product_id": {
                "type": "string"
              },
              "schema_url": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "product_url": {
                "type": "string"
              },
              "size_limits": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "product_id",
                      "unit",
                      "max_width_mm",
                      "max_height_mm",
                      "minimum_charge_width_mm",
                      "minimum_charge_height_mm",
                      "combination_dependent",
                      "availability_rule",
                      "width_drop_frontier",
                      "measurement_note",
                      "validation_note"
                    ],
                    "properties": {
                      "unit": {
                        "type": "string",
                        "const": "mm"
                      },
                      "product_id": {
                        "type": "string"
                      },
                      "max_width_mm": {
                        "type": "number"
                      },
                      "max_height_mm": {
                        "type": "number"
                      },
                      "validation_note": {
                        "type": "string"
                      },
                      "measurement_note": {
                        "type": "string"
                      },
                      "availability_rule": {
                        "type": "string"
                      },
                      "width_drop_frontier": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "width_band_max_mm",
                            "max_drop_mm"
                          ],
                          "properties": {
                            "max_drop_mm": {
                              "type": "number"
                            },
                            "width_band_max_mm": {
                              "type": "number"
                            }
                          },
                          "additionalProperties": true
                        }
                      },
                      "combination_dependent": {
                        "type": "boolean"
                      },
                      "minimum_order_width_mm": {
                        "type": "number"
                      },
                      "minimum_charge_width_mm": {
                        "type": "number"
                      },
                      "minimum_order_height_mm": {
                        "type": "number"
                      },
                      "minimum_charge_height_mm": {
                        "type": "number"
                      }
                    },
                    "additionalProperties": true
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "max_width_mm": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "suitable_for": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "max_height_mm": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "installation_type": {
                "type": "string"
              },
              "starting_price_zar": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "colour_count_in_stock": {
                "type": "number"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Get product details",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_quote_link",
          "title": "Create a shareable quote",
          "description": "Make a shareable quote page for the customer, with no side effects: no order, no email, no payment link and no stock hold. Each blind is priced and stock-checked now; the page shows the lines and total and its button fills the customer's cart and opens checkout, where prices are checked again. Valid 7 days. Use this when the customer wants to review, share or pay later, instead of create_checkout.",
          "inputSchema": {
            "type": "object",
            "required": [
              "items"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "colour",
                    "mount_type"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Exact available colour; validate with configure_product before adding"
                    },
                    "finish": {
                      "type": "string",
                      "description": "Optional pricing finish for aluminium Venetians"
                    },
                    "no_drill": {
                      "type": "boolean",
                      "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Number of blinds; defaults to 1"
                    },
                    "width_mm": {
                      "type": "number",
                      "description": "Actual ordered width in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "height_mm": {
                      "type": "number",
                      "description": "Actual ordered drop in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "mount_type": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Use inside for inside mount or outside for outside mount"
                    },
                    "product_id": {
                      "type": "string",
                      "description": "product_id returned by search_catalog or lookup_catalog"
                    },
                    "control_side": {
                      "enum": [
                        "left",
                        "right"
                      ],
                      "type": "string",
                      "description": "Chain or control side, as the customer faces the window. Defaults to right."
                    },
                    "product_name": {
                      "type": "string",
                      "description": "Optional; server resolves the catalogue name"
                    },
                    "unit_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all prices"
                    },
                    "total_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all totals"
                    }
                  }
                },
                "maxItems": 20,
                "minItems": 1,
                "description": "Configured blinds; validate colours with configure_product first"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "quote_id",
              "quote_url",
              "items",
              "item_count",
              "total_zar",
              "currency",
              "expires_at",
              "side_effects",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "quantity",
                    "unit_price_zar",
                    "total_price_zar"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "width_mm": {
                      "type": "number"
                    },
                    "height_mm": {
                      "type": "number"
                    },
                    "mount_type": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "control_side": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "unit_price_zar": {
                      "type": "number"
                    },
                    "total_price_zar": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "delivery": {
                "type": "string"
              },
              "quote_id": {
                "type": "string"
              },
              "quote_url": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "expires_at": {
                "type": "string"
              },
              "item_count": {
                "type": "number"
              },
              "side_effects": {
                "type": "string",
                "const": "none"
              },
              "vat_included": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Create a shareable quote",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "create_cart",
          "title": "Create a cart",
          "description": "Start the open UCP purchase flow, no auth needed. Creates a cart session and returns a cart_id (24-hour TTL). Optionally seed with pre-configured blind items and customer details. Next step: update_cart to add items, then create_checkout → complete_checkout to mint the payment link. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).",
          "inputSchema": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "colour",
                    "mount_type"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Exact available colour; validate with configure_product before adding"
                    },
                    "finish": {
                      "type": "string",
                      "description": "Optional pricing finish for aluminium Venetians"
                    },
                    "no_drill": {
                      "type": "boolean",
                      "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Number of blinds; defaults to 1"
                    },
                    "width_mm": {
                      "type": "number",
                      "description": "Actual ordered width in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "height_mm": {
                      "type": "number",
                      "description": "Actual ordered drop in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "mount_type": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Use inside for inside mount or outside for outside mount"
                    },
                    "product_id": {
                      "type": "string",
                      "description": "product_id returned by search_catalog or lookup_catalog"
                    },
                    "product_name": {
                      "type": "string",
                      "description": "Optional; server resolves the catalogue name"
                    },
                    "unit_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all prices"
                    },
                    "total_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all totals"
                    }
                  }
                },
                "description": "Optional configured items; all submitted prices are ignored"
              },
              "customer": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string",
                    "description": "Real customer name, checked before checkout creation"
                  },
                  "email": {
                    "type": "string",
                    "description": "Real customer email, checked before checkout creation"
                  },
                  "phone": {
                    "type": "string",
                    "description": "South African phone number, checked before checkout creation"
                  },
                  "address": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "cart_id",
              "items",
              "item_count",
              "total_zar",
              "currency",
              "customer",
              "created_at",
              "updated_at",
              "expires_at"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "quantity",
                    "unit_price_zar",
                    "total_price_zar"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string"
                    },
                    "finish": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "width_mm": {
                      "type": "number"
                    },
                    "height_mm": {
                      "type": "number"
                    },
                    "mount_type": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "unit_price_zar": {
                      "type": "number"
                    },
                    "total_price_zar": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "cart_id": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "city": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "email": {
                        "type": "string"
                      },
                      "phone": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "address": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": true
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total_zar": {
                "type": "number"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "item_count": {
                "type": "number"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Create a cart",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_cart",
          "title": "View a cart",
          "description": "Retrieve live cart state by cart_id: full item list, calculated totals in ZAR, and any customer details stored so far. Call after update_cart to confirm changes are correct before proceeding to create_checkout. Cart expires after 24 hours of inactivity.",
          "inputSchema": {
            "type": "object",
            "required": [
              "cart_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "cart_id",
              "items",
              "item_count",
              "total_zar",
              "currency",
              "customer",
              "created_at",
              "updated_at",
              "expires_at"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "quantity",
                    "unit_price_zar",
                    "total_price_zar"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string"
                    },
                    "finish": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "width_mm": {
                      "type": "number"
                    },
                    "height_mm": {
                      "type": "number"
                    },
                    "mount_type": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "unit_price_zar": {
                      "type": "number"
                    },
                    "total_price_zar": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "cart_id": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "city": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "email": {
                        "type": "string"
                      },
                      "phone": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "address": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": true
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total_zar": {
                "type": "number"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "item_count": {
                "type": "number"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "View a cart",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_cart",
          "title": "Update a cart",
          "description": "Modify an open cart before checkout. op: 'add' appends items, 'remove' drops items by 0-based index, 'set' replaces the full item list, 'clear' empties the cart. Merges customer details (name, email, phone) via the customer field. Call get_cart afterwards to confirm. Cannot modify a cart that already has a checkout in progress.",
          "inputSchema": {
            "type": "object",
            "required": [
              "cart_id"
            ],
            "properties": {
              "op": {
                "enum": [
                  "add",
                  "remove",
                  "set",
                  "clear"
                ],
                "type": "string",
                "default": "set"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "colour",
                    "mount_type"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Exact available colour; validate with configure_product before adding"
                    },
                    "finish": {
                      "type": "string",
                      "description": "Optional pricing finish for aluminium Venetians"
                    },
                    "no_drill": {
                      "type": "boolean",
                      "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Number of blinds; defaults to 1"
                    },
                    "width_mm": {
                      "type": "number",
                      "description": "Actual ordered width in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "height_mm": {
                      "type": "number",
                      "description": "Actual ordered drop in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "mount_type": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Use inside for inside mount or outside for outside mount"
                    },
                    "product_id": {
                      "type": "string",
                      "description": "product_id returned by search_catalog or lookup_catalog"
                    },
                    "product_name": {
                      "type": "string",
                      "description": "Optional; server resolves the catalogue name"
                    },
                    "unit_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all prices"
                    },
                    "total_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all totals"
                    }
                  }
                }
              },
              "cart_id": {
                "type": "string"
              },
              "indices": {
                "type": "array",
                "items": {
                  "type": "number"
                },
                "description": "Item indices to remove (0-based) when op='remove'"
              },
              "customer": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string",
                    "description": "Real customer name, checked before checkout creation"
                  },
                  "email": {
                    "type": "string",
                    "description": "Real customer email, checked before checkout creation"
                  },
                  "phone": {
                    "type": "string",
                    "description": "South African phone number, checked before checkout creation"
                  },
                  "address": {
                    "type": "string"
                  }
                }
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "cart_id",
              "items",
              "item_count",
              "total_zar",
              "currency",
              "customer",
              "created_at",
              "updated_at",
              "expires_at"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "quantity",
                    "unit_price_zar",
                    "total_price_zar"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string"
                    },
                    "finish": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "width_mm": {
                      "type": "number"
                    },
                    "height_mm": {
                      "type": "number"
                    },
                    "mount_type": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "unit_price_zar": {
                      "type": "number"
                    },
                    "total_price_zar": {
                      "type": "number"
                    }
                  },
                  "additionalProperties": true
                }
              },
              "cart_id": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [],
                    "properties": {
                      "city": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "name": {
                        "type": "string"
                      },
                      "email": {
                        "type": "string"
                      },
                      "phone": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "address": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": true
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "total_zar": {
                "type": "number"
              },
              "created_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "item_count": {
                "type": "number"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Update a cart",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "cancel_cart",
          "title": "Cancel a cart",
          "description": "Permanently delete a cart by cart_id. Use when the customer abandons the session or wants to start over. Has no effect on any checkout or paid order already created from this cart. Irreversible, create a new cart to restart.",
          "inputSchema": {
            "type": "object",
            "required": [
              "cart_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "cancelled",
              "cart_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string"
              },
              "cancelled": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Cancel a cart",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "create_checkout",
          "title": "Start checkout",
          "description": "Phase 1 of 2 in the purchase flow. Convert a cart (or inline items + customer) into a checkout. Customer name, email, and phone are required. Returns checkout_id. No payment link is minted yet, call complete_checkout for that. Use update_checkout to correct customer details before finalising.",
          "inputSchema": {
            "type": "object",
            "anyOf": [
              {
                "required": [
                  "cart_id"
                ]
              },
              {
                "required": [
                  "items",
                  "customer"
                ],
                "properties": {
                  "customer": {
                    "required": [
                      "name",
                      "email",
                      "phone"
                    ]
                  }
                }
              }
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "width_mm",
                    "height_mm",
                    "colour",
                    "mount_type"
                  ],
                  "properties": {
                    "colour": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Exact available colour; validate with configure_product before adding"
                    },
                    "finish": {
                      "type": "string",
                      "description": "Optional pricing finish for aluminium Venetians"
                    },
                    "no_drill": {
                      "type": "boolean",
                      "description": "Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."
                    },
                    "quantity": {
                      "type": "number",
                      "description": "Number of blinds; defaults to 1"
                    },
                    "width_mm": {
                      "type": "number",
                      "description": "Actual ordered width in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "height_mm": {
                      "type": "number",
                      "description": "Actual ordered drop in millimetres",
                      "exclusiveMinimum": 0
                    },
                    "mount_type": {
                      "type": "string",
                      "minLength": 1,
                      "description": "Use inside for inside mount or outside for outside mount"
                    },
                    "product_id": {
                      "type": "string",
                      "description": "product_id returned by search_catalog or lookup_catalog"
                    },
                    "product_name": {
                      "type": "string",
                      "description": "Optional; server resolves the catalogue name"
                    },
                    "unit_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all prices"
                    },
                    "total_price_zar": {
                      "type": "number",
                      "description": "Optional, ignored: server recalculates all totals"
                    }
                  }
                },
                "minItems": 1
              },
              "cart_id": {
                "type": "string",
                "description": "Either cart_id or items required"
              },
              "customer": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string",
                    "description": "Real customer name, checked before checkout creation"
                  },
                  "email": {
                    "type": "string",
                    "description": "Real customer email, checked before checkout creation"
                  },
                  "phone": {
                    "type": "string",
                    "description": "South African phone number, checked before checkout creation"
                  },
                  "address": {
                    "type": "string"
                  }
                }
              },
              "payment_method": {
                "enum": [
                  "yoco",
                  "ozow"
                ],
                "type": "string",
                "description": "Default 'yoco'"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "checkout_id",
              "status",
              "total_zar",
              "currency"
            ],
            "properties": {
              "ap2": {
                "type": "object",
                "required": [
                  "merchant_authorization"
                ],
                "properties": {
                  "merchant_authorization": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "items": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [],
                      "properties": {
                        "colour": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "drop_mm": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "width_mm": {
                          "type": "number"
                        },
                        "mount_type": {
                          "type": "string"
                        },
                        "unit_price": {
                          "type": "number"
                        },
                        "total_price": {
                          "type": "number"
                        },
                        "product_name": {
                          "type": "string"
                        },
                        "product_slug": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "type": "object",
                "required": [],
                "properties": {
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": true
              },
              "next_step": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "item_count": {
                "type": "number"
              },
              "checkout_id": {
                "type": "string"
              },
              "payment_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "payment_method": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_reference": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Start checkout",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_checkout",
          "title": "View checkout",
          "description": "Read checkout by checkout_id. Returns persisted order status, payment_status, payment_method, items, customer, total_zar and currency. Initial order status is started, not pending. This tool does not return a previously generated payment_url: retain the complete_checkout response in caller context.",
          "inputSchema": {
            "type": "object",
            "required": [
              "checkout_id"
            ],
            "properties": {
              "checkout_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "checkout_id",
              "status",
              "total_zar",
              "currency"
            ],
            "properties": {
              "ap2": {
                "type": "object",
                "required": [
                  "merchant_authorization"
                ],
                "properties": {
                  "merchant_authorization": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "items": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [],
                      "properties": {
                        "colour": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "drop_mm": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "width_mm": {
                          "type": "number"
                        },
                        "mount_type": {
                          "type": "string"
                        },
                        "unit_price": {
                          "type": "number"
                        },
                        "total_price": {
                          "type": "number"
                        },
                        "product_name": {
                          "type": "string"
                        },
                        "product_slug": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "type": "object",
                "required": [],
                "properties": {
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": true
              },
              "next_step": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "item_count": {
                "type": "number"
              },
              "checkout_id": {
                "type": "string"
              },
              "payment_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "payment_method": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_reference": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "View checkout",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_checkout",
          "title": "Update checkout details",
          "description": "Update customer details or payment_method only before payment-link generation. Paid, cancelled and payment-in-progress checkouts are rejected. Concurrent state changes are detected; retrieve the latest status before retrying.",
          "inputSchema": {
            "type": "object",
            "required": [
              "checkout_id"
            ],
            "properties": {
              "customer": {
                "type": "object",
                "properties": {
                  "city": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string",
                    "description": "Real customer name, checked before checkout creation"
                  },
                  "email": {
                    "type": "string",
                    "description": "Real customer email, checked before checkout creation"
                  },
                  "phone": {
                    "type": "string",
                    "description": "South African phone number, checked before checkout creation"
                  },
                  "address": {
                    "type": "string"
                  }
                }
              },
              "checkout_id": {
                "type": "string"
              },
              "payment_method": {
                "enum": [
                  "yoco",
                  "ozow"
                ],
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "checkout_id",
              "status",
              "total_zar",
              "currency"
            ],
            "properties": {
              "ap2": {
                "type": "object",
                "required": [
                  "merchant_authorization"
                ],
                "properties": {
                  "merchant_authorization": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "items": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [],
                      "properties": {
                        "colour": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "drop_mm": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "width_mm": {
                          "type": "number"
                        },
                        "mount_type": {
                          "type": "string"
                        },
                        "unit_price": {
                          "type": "number"
                        },
                        "total_price": {
                          "type": "number"
                        },
                        "product_name": {
                          "type": "string"
                        },
                        "product_slug": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "type": "object",
                "required": [],
                "properties": {
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": true
              },
              "next_step": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "item_count": {
                "type": "number"
              },
              "checkout_id": {
                "type": "string"
              },
              "payment_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "payment_method": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_reference": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Update checkout details",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "complete_checkout",
          "title": "Get the payment link",
          "description": "Generate a Yoco card or Ozow instant-EFT payment link; this does NOT complete payment. Rejects cancelled checkouts and rechecks stock and totals first. An atomic claim prevents competing gateway calls. Returns payment_url or null plus status and message. Retain a successful URL: repeat calls return payment_pending with no URL. Gateway failures raise an error, send no payment-link email and require team review rather than an automatic retry. Poll get_order with customer_email for payment status.",
          "inputSchema": {
            "type": "object",
            "required": [
              "checkout_id"
            ],
            "properties": {
              "checkout_id": {
                "type": "string"
              },
              "payment_method": {
                "enum": [
                  "yoco",
                  "ozow"
                ],
                "type": "string",
                "description": "Overrides any value set in create_checkout/update_checkout"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "allOf": [
              {
                "if": {
                  "required": [
                    "payment_url"
                  ],
                  "properties": {
                    "payment_url": {
                      "type": "string"
                    }
                  }
                },
                "then": {
                  "required": [
                    "total_zar",
                    "currency",
                    "payment_method"
                  ]
                }
              }
            ],
            "required": [
              "checkout_id",
              "status",
              "payment_url",
              "message"
            ],
            "properties": {
              "ap2": {
                "type": "object",
                "required": [
                  "merchant_authorization"
                ],
                "properties": {
                  "merchant_authorization": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "items": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [],
                      "properties": {
                        "colour": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "drop_mm": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "width_mm": {
                          "type": "number"
                        },
                        "mount_type": {
                          "type": "string"
                        },
                        "unit_price": {
                          "type": "number"
                        },
                        "total_price": {
                          "type": "number"
                        },
                        "product_name": {
                          "type": "string"
                        },
                        "product_slug": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "type": "string"
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "customer": {
                "type": "object",
                "required": [],
                "properties": {
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "additionalProperties": true
              },
              "next_step": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "item_count": {
                "type": "number"
              },
              "checkout_id": {
                "type": "string"
              },
              "payment_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "payment_method": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "provider_reference": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Get the payment link",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "cancel_checkout",
          "title": "Cancel checkout",
          "description": "Abort an unpaid checkout and release its checkout_id. Use if the customer changes their mind after create_checkout but before completing payment. Has no effect on orders already confirmed by webhook. To restart, create a new cart and checkout from scratch.",
          "inputSchema": {
            "type": "object",
            "required": [
              "checkout_id"
            ],
            "properties": {
              "checkout_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "checkout_id",
              "status"
            ],
            "properties": {
              "status": {
                "type": "string"
              },
              "checkout_id": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Cancel checkout",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "get_order",
          "title": "Check an order",
          "description": "Retrieve a confirmed order's status, items, and payment details by order_id. customer_email is required as soft-auth and must exactly match the order record, prevents arbitrary order lookups. Returns payment status (paid | pending | failed), production status, and dispatch date once available.",
          "inputSchema": {
            "type": "object",
            "required": [
              "order_id",
              "customer_email"
            ],
            "properties": {
              "order_id": {
                "type": "string"
              },
              "customer_email": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "order_id",
              "payment_status",
              "total_zar",
              "currency"
            ],
            "properties": {
              "items": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [],
                      "properties": {
                        "colour": {
                          "anyOf": [
                            {
                              "type": "string"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "drop_mm": {
                          "type": "number"
                        },
                        "quantity": {
                          "type": "number"
                        },
                        "width_mm": {
                          "type": "number"
                        },
                        "mount_type": {
                          "type": "string"
                        },
                        "unit_price": {
                          "type": "number"
                        },
                        "total_price": {
                          "type": "number"
                        },
                        "product_name": {
                          "type": "string"
                        },
                        "product_slug": {
                          "type": "string"
                        }
                      },
                      "additionalProperties": true
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "paid_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "currency": {
                "type": "string",
                "const": "ZAR"
              },
              "order_id": {
                "type": "string"
              },
              "lead_time": {
                "type": "string"
              },
              "total_zar": {
                "type": "number"
              },
              "order_status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "payment_status": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "order_reference": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Check an order",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "check_colour_stock",
          "title": "Check colour stock",
          "description": "Verify whether a specific colour is available before configure_product. Returns in_stock boolean, expected_restock_date if out of stock, and up to 5 alternative in-stock colours ordered by similarity. Call this when a customer requests a named colour or when you want to prevent a configure_product failure due to an out-of-stock selection. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "colour_name"
            ],
            "properties": {
              "product_id": {
                "type": "string"
              },
              "colour_name": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "in_stock"
            ],
            "properties": {
              "found": {
                "type": "boolean"
              },
              "colour": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "in_stock": {
                "type": "boolean"
              },
              "product_id": {
                "type": "string"
              },
              "expected_restock": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "matching_colours": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "name",
                    "in_stock"
                  ],
                  "properties": {
                    "hex": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "name": {
                      "type": "string"
                    },
                    "finish": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "in_stock": {
                      "type": "boolean"
                    },
                    "material": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "expected_restock": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              },
              "available_colours": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "exact_colour_match": {
                "type": "boolean"
              },
              "requires_exact_colour_selection": {
                "type": "boolean"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Check colour stock",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "request_swatch",
          "title": "Request fabric swatches",
          "description": "Log up to 5 colour codes against an EXISTING order for the team (order_ref required; without it the tool returns status order_required and logs nothing). Sample swatches, not off-cuts: on orders over R8,000 the customer can ask on WhatsApp for swatches in the colours they like, for the product they are ordering; if nothing suits, full refund with no fees. Never quote a sample price or courier cost.",
          "inputSchema": {
            "type": "object",
            "required": [
              "customer_name",
              "customer_email",
              "customer_phone",
              "product_interest",
              "order_ref"
            ],
            "properties": {
              "suburb": {
                "type": "string",
                "description": "Optional delivery suburb"
              },
              "order_ref": {
                "type": "string",
                "description": "The order reference the swatches ship with. Required."
              },
              "swatch_codes": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Optional specific colour codes (max 5)"
              },
              "customer_name": {
                "type": "string",
                "description": "Customer's full name."
              },
              "customer_email": {
                "type": "string",
                "description": "Customer's email address."
              },
              "customer_phone": {
                "type": "string",
                "description": "Used as WhatsApp number"
              },
              "product_interest": {
                "type": "string",
                "description": "e.g. 'Roller Blockout' or 'Honeycomb'"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "status",
              "message"
            ],
            "properties": {
              "policy": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "next_step": {
                "type": "string"
              },
              "order_ref": {
                "type": "string"
              },
              "request_id": {
                "type": "number"
              },
              "swatch_count": {
                "type": "number"
              },
              "estimated_delivery_days": {
                "type": "object",
                "required": [
                  "min",
                  "max"
                ],
                "properties": {
                  "max": {
                    "type": "number"
                  },
                  "min": {
                    "type": "number"
                  }
                },
                "additionalProperties": true
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Request fabric swatches",
            "readOnlyHint": false,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_payment_methods",
          "title": "List payment methods",
          "description": "List available payment processors and their capabilities. Returns Yoco (card, immediate) and Ozow (instant EFT via South African bank account). Call when the customer asks 'how can I pay?' or before presenting options. The result informs the payment_method field in create_checkout and complete_checkout.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "order_total_zar": {
                "type": "number",
                "description": "Optional. For future per-handler limit filtering."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "default_currency",
              "handlers",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "handlers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "id",
                    "name",
                    "supports"
                  ],
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "note": {
                      "type": "string"
                    },
                    "supports": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "additionalProperties": true
                }
              },
              "default_currency": {
                "type": "string",
                "const": "ZAR"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "List payment methods",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_whatsapp_handoff",
          "title": "Hand over to WhatsApp",
          "description": "Generate a pre-filled WhatsApp deep link to hand the customer off to the right contact. Garden Route locations (Knysna, Plett, George, Sedgefield, etc.) route to Duncan Kane on WhatsApp (+27795235407) for a free in-home consultation. Awnings, shutters, shadeports and Ziptrak, named in product_context, route to Duncan Kane from anywhere in South Africa. Everything else routes to the shop WhatsApp (+27760228410), WhatsApp only, no voice calls. Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "message": {
                "type": "string",
                "description": "Optional additional message to prefill"
              },
              "location": {
                "type": "string",
                "description": "City/suburb. Garden Route locations route to Duncan."
              },
              "customer_name": {
                "type": "string"
              },
              "product_context": {
                "type": "string",
                "description": "e.g. 'roller blockout for bedroom'. Awnings, shutters, shadeports or Ziptrak here route to Duncan."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "whatsapp_url",
              "recipient",
              "recipient_phone",
              "reason"
            ],
            "properties": {
              "reason": {
                "type": "string"
              },
              "recipient": {
                "type": "string"
              },
              "whatsapp_url": {
                "type": "string"
              },
              "recipient_phone": {
                "type": "string"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Hand over to WhatsApp",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_product_recommendation",
          "title": "Recommend a blind",
          "description": "Translate a customer's primary concern into a product recommendation. primary_concern must be one of: blockout, heat, glare, moisture, privacy, security, automation. Optionally narrow by room (bedroom, lounge, etc.), location, budget, and aesthetic. Returns a recommended product_id with rationale, pass it to get_price or configure_product next. For security there is no shop product: it returns a hand-off to our security shutters page (installed in the Garden Route only).",
          "inputSchema": {
            "type": "object",
            "required": [
              "primary_concern"
            ],
            "properties": {
              "room": {
                "type": "string"
              },
              "location": {
                "type": "string"
              },
              "aesthetic": {
                "type": "string"
              },
              "max_budget_zar": {
                "type": "number"
              },
              "primary_concern": {
                "enum": [
                  "blockout",
                  "heat",
                  "glare",
                  "moisture",
                  "privacy",
                  "security",
                  "automation"
                ],
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "recommendations"
            ],
            "properties": {
              "notes": {
                "type": "string"
              },
              "handoff": {
                "type": "object",
                "required": [
                  "url",
                  "product_family",
                  "reason"
                ],
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  },
                  "product_family": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "recommendations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "product_name",
                    "reason",
                    "starting_price_zar_for_1m_x_1m",
                    "currency",
                    "shop_url"
                  ],
                  "properties": {
                    "reason": {
                      "type": "string"
                    },
                    "currency": {
                      "type": "string",
                      "const": "ZAR"
                    },
                    "shop_url": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "starting_price_zar_for_1m_x_1m": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Recommend a blind",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "get_ar_visualizer_url",
          "title": "Get the web visualiser link",
          "description": "Returns the link to the Custom Blinds Visualiser (See it before you buy it), pre-selected to the product when it is supported. The customer adds a photo of their window (any angle), picks a blind and colour, and previews it on their own window. A preview of colour and style, not a measuring tool. No measuring or marking. A name and WhatsApp number are needed; 2 free previews per customer. Also returns the measuring guide (mode 'measure' makes it the main url) and the list of supported products. A customer still unsure of sizes can order with best guess sizes, receive a free tape measure and confirm before production starts. Use when a customer wants to see how a blind or colour will look before ordering, or is unsure how to measure. If you already have the customer's photo, use start_visualiser_preview to show the blind in this chat instead.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "mode": {
                "enum": [
                  "measure",
                  "visualize",
                  "both"
                ],
                "type": "string",
                "description": "Which link goes in url: visualize (own-window visualiser), measure (measuring guide) or both (visualiser, the default). Both links are always returned."
              },
              "product_id": {
                "type": "string",
                "description": "Optional. Pre-select a product in the visualiser (e.g. roller-blockout, double-roller-zebra, outdoor-blinds)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "url",
              "visualiser_url",
              "measure_url",
              "note"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "note": {
                "type": "string"
              },
              "product_id": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "measure_url": {
                "type": "string"
              },
              "visualiser_url": {
                "type": "string"
              },
              "supported_products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "label"
                  ],
                  "properties": {
                    "label": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": true
                }
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Get the web visualiser link",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "start_visualiser_preview",
          "title": "Start a window or patio preview",
          "description": "Show the customer a blind on THEIR OWN window or patio, in this chat. Pass the photo they gave you (image_url https, or image_base64; for outdoor blinds, the patio opening taken straight on), the product_id and an exact in-stock colour name (get_product), and the customer's name and South African WhatsApp number (required: the team follows up on WhatsApp, and each number gets 2 free previews). Indoor blinds, and the outdoor screen, clear PVC and canvas blinds (not outdoor bamboo). Finds the windows or patio openings (20 to 45 s) and returns job_id; then call get_visualiser_preview. A preview of colour and style, not a measuring tool.",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "colour",
              "customer_name",
              "whatsapp"
            ],
            "properties": {
              "colour": {
                "type": "string",
                "description": "Exact in-stock colour name from get_product (for a Duo Roller, one of its listed colours)"
              },
              "whatsapp": {
                "type": "string",
                "description": "Customer's South African WhatsApp number"
              },
              "image_url": {
                "type": "string",
                "description": "https URL of the customer's window or patio photo (JPEG, PNG or WebP, under 6 MB)"
              },
              "product_id": {
                "type": "string",
                "description": "Visualiser blind, e.g. roller-blockout, duo-roller, venetian-25mm-aluminium, honeycomb-blockout, outdoor-blinds, outdoor-blinds-pvc, outdoor-blinds-canvas"
              },
              "image_base64": {
                "type": "string",
                "description": "Or the photo itself, base64"
              },
              "customer_name": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "job_id",
              "status",
              "product_id",
              "colour",
              "windows_found",
              "next_step"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "colour": {
                "type": "string"
              },
              "job_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "next_step": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "windows_found": {
                "type": "number"
              },
              "remaining_previews": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Start a window or patio preview",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_visualiser_preview",
          "title": "Get the window preview",
          "description": "Draw and return the preview for a job_id from start_visualiser_preview: the blind in the chosen colour on the customer's photo, as an image in the result and as image_url (kept 7 days). The first call draws it (30 to 90 s; outdoor up to 2 minutes); status \"drawing\" means call again after retry_after_seconds.",
          "inputSchema": {
            "type": "object",
            "required": [
              "job_id"
            ],
            "properties": {
              "job_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "job_id",
              "status"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "error": {
                "type": "string"
              },
              "colour": {
                "type": "string"
              },
              "job_id": {
                "type": "string"
              },
              "status": {
                "enum": [
                  "surveyed",
                  "drawing",
                  "done",
                  "failed"
                ],
                "type": "string"
              },
              "checked": {
                "type": "boolean"
              },
              "image_url": {
                "type": "string"
              },
              "image_mime": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "retry_after_seconds": {
                "type": "number"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Get the window preview",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_delivery_estimate",
          "title": "Estimate lead time and delivery",
          "description": "Lead time for a new order. Production takes 5 to 7 working days once payment clears, outside peak seasons. Pass the customer's town and 4-digit street postal_code (province and suburb help) and the transit range is The Courier Guy's own quote from our Knysna depot to that town; without them it is the standard 2 to 5 working days. Returns working-day ranges and a summary safe to share. Never quote a dispatch or delivery date: weather and production set them.",
          "inputSchema": {
            "type": "object",
            "properties": {
              "town": {
                "type": "string",
                "description": "Customer's town or city, e.g. 'Johannesburg'"
              },
              "suburb": {
                "type": "string",
                "description": "Optional suburb, e.g. Sandton"
              },
              "province": {
                "type": "string",
                "description": "Optional province, e.g. Gauteng"
              },
              "width_mm": {
                "type": "number",
                "description": "Optional widest blind in mm (sets the parcel length)"
              },
              "order_date": {
                "type": "string",
                "description": "ISO date of the order (e.g. '2026-05-18'). Defaults to today."
              },
              "postal_code": {
                "type": "string",
                "description": "4-digit South African STREET postal code, e.g. 2196"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "production_working_days_min",
              "production_working_days_max",
              "transit_working_days_min",
              "transit_working_days_max",
              "delivery_after_dispatch",
              "summary",
              "important"
            ],
            "properties": {
              "summary": {
                "type": "string"
              },
              "important": {
                "type": "string"
              },
              "order_date": {
                "type": "string"
              },
              "destination": {
                "type": "object",
                "required": [],
                "properties": {
                  "town": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              },
              "transit_note": {
                "type": "string"
              },
              "transit_source": {
                "enum": [
                  "courier_guy_quote",
                  "standard_range"
                ],
                "type": "string"
              },
              "courier_service": {
                "type": "string"
              },
              "production_starts": {
                "type": "string"
              },
              "expedited_available": {
                "type": "boolean"
              },
              "courier_high_risk_area": {
                "type": "boolean"
              },
              "delivery_after_dispatch": {
                "type": "string"
              },
              "transit_working_days_max": {
                "type": "number"
              },
              "transit_working_days_min": {
                "type": "number"
              },
              "production_working_days_max": {
                "type": "number"
              },
              "production_working_days_min": {
                "type": "number"
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Estimate lead time and delivery",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "request_price_match",
          "title": "Prepare a price-match request",
          "description": "Submit a price match claim when the customer has found the same blind at a lower price elsewhere. Custom Blinds matches verified South African retailer prices for identical product, dimensions, and specs. Returns a pre-filled WhatsApp link to the claims team. Not applicable to clearance or flash-sale prices, international retailers, or items out of stock at the other retailer. Requires product_id and competitor_price_zar at minimum.",
          "inputSchema": {
            "type": "object",
            "required": [
              "product_id",
              "competitor_price_zar"
            ],
            "properties": {
              "width_mm": {
                "type": "number",
                "description": "Window width in mm"
              },
              "height_mm": {
                "type": "number",
                "description": "Window height/drop in mm"
              },
              "product_id": {
                "type": "string",
                "description": "Product the customer wants to match (e.g. roller-blockout)"
              },
              "customer_name": {
                "type": "string",
                "description": "Customer name"
              },
              "competitor_url": {
                "type": "string",
                "description": "URL to competitor product page or quote"
              },
              "competitor_name": {
                "type": "string",
                "description": "Name of the other retailer"
              },
              "customer_whatsapp": {
                "type": "string",
                "description": "Customer WhatsApp number for follow-up"
              },
              "competitor_price_zar": {
                "type": "number",
                "description": "Competitor's price in ZAR (incl. VAT)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "success",
              "claim_summary",
              "whatsapp_url",
              "message",
              "exclusions",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "success": {
                "type": "boolean"
              },
              "exclusions": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "whatsapp_url": {
                "type": "string"
              },
              "claim_summary": {
                "type": "object",
                "required": [
                  "product_id",
                  "dimensions",
                  "competitor",
                  "competitor_price_zar"
                ],
                "properties": {
                  "competitor": {
                    "type": "string"
                  },
                  "dimensions": {
                    "type": "string"
                  },
                  "product_id": {
                    "type": "string"
                  },
                  "competitor_price_zar": {
                    "type": "string"
                  }
                },
                "additionalProperties": true
              }
            },
            "additionalProperties": true
          },
          "annotations": {
            "title": "Prepare a price-match request",
            "readOnlyHint": true,
            "openWorldHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": "Custom Blinds shop (shop.customblinds.co.za): made-to-measure blinds in South Africa. All prices are ZAR, VAT included. Flow: search_catalog or lookup_catalog, get_product, get_price, configure_product (validates an exact colour; use check_colour_stock for a named colour), then create_quote_link. create_quote_link is the default way to finish: it returns a shareable quote page, valid 7 days, that fills the customer's cart on shop.customblinds.co.za, where they pay at checkout. No order is created and no personal details are needed in the chat. Use create_cart, create_checkout and complete_checkout only when the customer asks to pay from this chat and has given their real details. Browsing, pricing, cart and checkout are open; submit_enquiry and create_order need a partner Bearer key. create_checkout creates a real unpaid order: confirm product, size, colour, total and the customer's real name, email, mobile and delivery address before calling it. Test or placeholder details are refused. complete_checkout then creates the payment link; a link is not a payment. If the status is payment_link_review, tell the customer the team will follow up on WhatsApp and do not create another checkout. Duo Roller is two independent fabric rolls with stronger room darkening. Zebra (Double Roller) is one fabric with alternating stripes that lets more light through when closed. Never treat them as the same product. Before pricing a size, validate_measurement checks it against the shop's limits, mount and no-drill rules and says what to fix. Do not promise delivery dates; get_delivery_estimate with the customer's town and postal code returns production and Courier Guy transit ranges in working days only. To see a blind in the customer's own window, use get_ar_visualizer_url (the Custom Blinds Visualiser: See it before you buy it; a preview, not a measuring tool). Roman blinds come in two ranges: the Urban Range (urban-roman-blinds, roller blind fabric, stainless steel chain) is on sale now; the Brenton Range (linen-look weave, handmade in Knysna) is launching soon: its page https://shop.customblinds.co.za/brenton-roman-blinds shows the options but it is not for sale, so never price it or take an order for it, and offer the Urban Range instead. Off-cuts are not posted. On orders over R8,000 sample swatches go on request, in the colours the customer likes, for the product they are ordering. Never quote a sample price or courier cost. Online shop contact is WhatsApp +27 76 022 8410 only, never a phone call. Garden Route customers (Knysna, Plett, George and surrounds) and all awnings, shutters, shadeports and Ziptrak go to Duncan Kane on WhatsApp +27 79 523 5407 for a free consultation; get_whatsapp_handoff builds the link. Current offer: Black November: 10% off the blind price of sheer (screen) outdoor blinds and canvas outdoor blinds 3000mm wide and over, until 30 November 2026 (SA time). Not PVC or outdoor bamboo, and not on motors, remotes or kits. get_price already includes it and returns promo with the price before it."
  },
  "changes": {
    "total": 1,
    "latest": [
      {
        "observed_at": "2026-11-22T18:29:02.258Z",
        "from_sha": "76bf7ded07d62abcb77dcc335237f65f6b6211691234a5b12a06ee0802450692",
        "to_sha": "2687eea09090e311a01343e6afa2bd01f50d9766111dddc9666e76c8410abaef",
        "summary": {
          "tool_changed": 7
        },
        "diff": [
          {
            "op": "changed",
            "kind": "tool",
            "name": "validate_measurement",
            "path": "/inputSchema/properties/mount_type/description",
            "after": "inside (in the recess) or outside mount",
            "before": "inside (in the recess) or outside (face fix)"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "validate_measurement",
            "path": "/inputSchema/properties/opening_drop_mm/description",
            "after": "Optional, outside mount only: drop of the opening itself",
            "before": "Optional, face fix only: drop of the opening itself"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "validate_measurement",
            "path": "/inputSchema/properties/opening_width_mm/description",
            "after": "Optional, outside mount only: width of the opening itself",
            "before": "Optional, face fix only: width of the opening itself"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_quote_link",
            "path": "/inputSchema/properties/items/items/properties/mount_type/description",
            "after": "Use inside for inside mount or outside for outside mount",
            "before": "Use inside for inside mount or outside for face fix"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_cart",
            "path": "/inputSchema/properties/items/items/properties/mount_type/description",
            "after": "Use inside for inside mount or outside for outside mount",
            "before": "Use inside for inside mount or outside for face fix"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "update_cart",
            "path": "/inputSchema/properties/items/items/properties/mount_type/description",
            "after": "Use inside for inside mount or outside for outside mount",
            "before": "Use inside for inside mount or outside for face fix"
          },
          {
            "op": "changed",
            "kind": "tool",
            "name": "create_checkout",
            "path": "/inputSchema/properties/items/items/properties/mount_type/description",
            "after": "Use inside for inside mount or outside for outside mount",
            "before": "Use inside for inside mount or outside for face fix"
          }
        ],
        "withheld": false
      }
    ]
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}