Server definition
- Hash
- sha256:704fd1606e0145c1e56115d404eb54f2cf3d9137674becf95c6d9262e837240d
- What it is
- What a remote MCP server returned when asked what it offers: 27 tools
The blob, as servednamed by its sha256
{
"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), create_cart, create_checkout, complete_checkout. 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 held_for_verification or 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. To hand the customer a ready basket without creating an order, create_quote_link returns a shareable page that fills their cart; nothing is ordered until they pay at checkout. 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.",
"tools": [
{
"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": {
"properties": {
"cart_id": {
"type": "string"
}
},
"required": [
"cart_id"
],
"type": "object"
},
"name": "cancel_cart",
"outputSchema": {
"additionalProperties": true,
"properties": {
"cancelled": {
"type": "boolean"
},
"cart_id": {
"type": "string"
}
},
"required": [
"cancelled",
"cart_id"
],
"type": "object"
}
},
{
"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": {
"properties": {
"checkout_id": {
"type": "string"
}
},
"required": [
"checkout_id"
],
"type": "object"
},
"name": "cancel_checkout",
"outputSchema": {
"additionalProperties": true,
"properties": {
"checkout_id": {
"type": "string"
},
"status": {
"type": "string"
}
},
"required": [
"checkout_id",
"status"
],
"type": "object"
}
},
{
"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": {
"properties": {
"colour_name": {
"type": "string"
},
"product_id": {
"type": "string"
}
},
"required": [
"product_id",
"colour_name"
],
"type": "object"
},
"name": "check_colour_stock",
"outputSchema": {
"additionalProperties": true,
"properties": {
"available_colours": {
"items": {
"type": "string"
},
"type": "array"
},
"colour": {
"type": "string"
},
"exact_colour_match": {
"type": "boolean"
},
"expected_restock": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"found": {
"type": "boolean"
},
"in_stock": {
"type": "boolean"
},
"matching_colours": {
"items": {
"additionalProperties": true,
"properties": {
"expected_restock": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"in_stock"
],
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
},
"product_id": {
"type": "string"
},
"requires_exact_colour_selection": {
"type": "boolean"
}
},
"required": [
"in_stock"
],
"type": "object"
}
},
{
"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; cloud callers may be held. 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": {
"properties": {
"checkout_id": {
"type": "string"
},
"payment_method": {
"description": "Overrides any value set in create_checkout/update_checkout",
"enum": [
"yoco",
"ozow"
],
"type": "string"
}
},
"required": [
"checkout_id"
],
"type": "object"
},
"name": "complete_checkout",
"outputSchema": {
"additionalProperties": true,
"allOf": [
{
"if": {
"properties": {
"payment_url": {
"type": "string"
}
},
"required": [
"payment_url"
]
},
"then": {
"required": [
"total_zar",
"currency",
"payment_method"
]
}
}
],
"properties": {
"ap2": {
"additionalProperties": true,
"properties": {
"merchant_authorization": {
"type": "string"
}
},
"required": [
"merchant_authorization"
],
"type": "object"
},
"checkout_id": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"item_count": {
"type": "number"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"drop_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_name": {
"type": "string"
},
"product_slug": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"next_step": {
"type": "string"
},
"payment_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"payment_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_zar": {
"type": "number"
}
},
"required": [
"checkout_id",
"status",
"payment_url",
"message"
],
"type": "object"
}
},
{
"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": {
"properties": {
"colour": {
"description": "Colour name (must match available colours)",
"type": "string"
},
"finish": {
"description": "Optional finish for aluminium venetians",
"type": "string"
},
"height_mm": {
"description": "Height/drop in millimetres",
"type": "number"
},
"mount_type": {
"description": "Use inside (recess) or outside (face-fix); handler requires a nonempty value",
"minLength": 1,
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id from search_catalog or lookup_catalog",
"type": "string"
},
"province": {
"description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.",
"type": "string"
},
"quantity": {
"description": "Number of blinds (default 1)",
"type": "number"
},
"width_mm": {
"description": "Width in millimetres",
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"type": "object"
},
"name": "configure_product",
"outputSchema": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"contact": {
"additionalProperties": true,
"properties": {
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"whatsapp": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"delivery": {
"type": "string"
},
"effective_height_mm": {
"type": "number"
},
"effective_width_mm": {
"type": "number"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"height_mm": {
"type": "number"
},
"in_stock": {
"type": "boolean"
},
"lead_time": {
"type": "string"
},
"limits": {
"additionalProperties": true,
"properties": {},
"required": [],
"type": "object"
},
"minimum_charge_applied": {
"type": "boolean"
},
"mount_type": {
"type": "string"
},
"next_step": {
"type": "string"
},
"price_zar": {
"type": "number"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"summary": {
"type": "string"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"vat_included": {
"type": "boolean"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type",
"quantity",
"unit_price_zar",
"total_price_zar",
"currency"
],
"type": "object"
}
},
{
"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": {
"properties": {
"customer": {
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"email": {
"description": "Real customer email, checked before checkout creation",
"type": "string"
},
"name": {
"description": "Real customer name, checked before checkout creation",
"type": "string"
},
"phone": {
"description": "South African phone number, checked before checkout creation",
"type": "string"
}
},
"type": "object"
},
"items": {
"description": "Optional configured items; all submitted prices are ignored",
"items": {
"properties": {
"colour": {
"description": "Exact available colour; validate with configure_product before adding",
"minLength": 1,
"type": "string"
},
"finish": {
"description": "Optional pricing finish for aluminium Venetians",
"type": "string"
},
"height_mm": {
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0,
"type": "number"
},
"mount_type": {
"description": "Use inside for inside mount or outside for face fix",
"minLength": 1,
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id returned by search_catalog or lookup_catalog",
"type": "string"
},
"product_name": {
"description": "Optional; server resolves the catalogue name",
"type": "string"
},
"quantity": {
"description": "Number of blinds; defaults to 1",
"type": "number"
},
"total_price_zar": {
"description": "Optional, ignored: server recalculates all totals",
"type": "number"
},
"unit_price_zar": {
"description": "Optional, ignored: server recalculates all prices",
"type": "number"
},
"width_mm": {
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"name": "create_cart",
"outputSchema": {
"additionalProperties": true,
"properties": {
"cart_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
{
"type": "null"
}
]
},
"expires_at": {
"type": "string"
},
"item_count": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"height_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"quantity",
"unit_price_zar",
"total_price_zar"
],
"type": "object"
},
"type": "array"
},
"total_zar": {
"type": "number"
},
"updated_at": {
"type": "string"
}
},
"required": [
"cart_id",
"items",
"item_count",
"total_zar",
"currency",
"customer",
"created_at",
"updated_at",
"expires_at"
],
"type": "object"
}
},
{
"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": {
"anyOf": [
{
"required": [
"cart_id"
]
},
{
"properties": {
"customer": {
"required": [
"name",
"email",
"phone"
]
}
},
"required": [
"items",
"customer"
]
}
],
"properties": {
"cart_id": {
"description": "Either cart_id or items required",
"type": "string"
},
"customer": {
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"email": {
"description": "Real customer email, checked before checkout creation",
"type": "string"
},
"name": {
"description": "Real customer name, checked before checkout creation",
"type": "string"
},
"phone": {
"description": "South African phone number, checked before checkout creation",
"type": "string"
}
},
"type": "object"
},
"items": {
"items": {
"properties": {
"colour": {
"description": "Exact available colour; validate with configure_product before adding",
"minLength": 1,
"type": "string"
},
"finish": {
"description": "Optional pricing finish for aluminium Venetians",
"type": "string"
},
"height_mm": {
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0,
"type": "number"
},
"mount_type": {
"description": "Use inside for inside mount or outside for face fix",
"minLength": 1,
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id returned by search_catalog or lookup_catalog",
"type": "string"
},
"product_name": {
"description": "Optional; server resolves the catalogue name",
"type": "string"
},
"quantity": {
"description": "Number of blinds; defaults to 1",
"type": "number"
},
"total_price_zar": {
"description": "Optional, ignored: server recalculates all totals",
"type": "number"
},
"unit_price_zar": {
"description": "Optional, ignored: server recalculates all prices",
"type": "number"
},
"width_mm": {
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"type": "object"
},
"minItems": 1,
"type": "array"
},
"payment_method": {
"description": "Default 'yoco'",
"enum": [
"yoco",
"ozow"
],
"type": "string"
}
},
"type": "object"
},
"name": "create_checkout",
"outputSchema": {
"additionalProperties": true,
"properties": {
"ap2": {
"additionalProperties": true,
"properties": {
"merchant_authorization": {
"type": "string"
}
},
"required": [
"merchant_authorization"
],
"type": "object"
},
"checkout_id": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"item_count": {
"type": "number"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"drop_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_name": {
"type": "string"
},
"product_slug": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"next_step": {
"type": "string"
},
"payment_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"payment_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_zar": {
"type": "number"
}
},
"required": [
"checkout_id",
"status",
"total_zar",
"currency"
],
"type": "object"
}
},
{
"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": {
"properties": {
"items": {
"description": "Configured blinds; validate colours with configure_product first",
"items": {
"properties": {
"colour": {
"description": "Exact available colour; validate with configure_product before adding",
"minLength": 1,
"type": "string"
},
"control_side": {
"description": "Chain or control side, as the customer faces the window. Defaults to right.",
"enum": [
"left",
"right"
],
"type": "string"
},
"finish": {
"description": "Optional pricing finish for aluminium Venetians",
"type": "string"
},
"height_mm": {
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0,
"type": "number"
},
"mount_type": {
"description": "Use inside for inside mount or outside for face fix",
"minLength": 1,
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id returned by search_catalog or lookup_catalog",
"type": "string"
},
"product_name": {
"description": "Optional; server resolves the catalogue name",
"type": "string"
},
"quantity": {
"description": "Number of blinds; defaults to 1",
"type": "number"
},
"total_price_zar": {
"description": "Optional, ignored: server recalculates all totals",
"type": "number"
},
"unit_price_zar": {
"description": "Optional, ignored: server recalculates all prices",
"type": "number"
},
"width_mm": {
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"type": "object"
},
"maxItems": 20,
"minItems": 1,
"type": "array"
}
},
"required": [
"items"
],
"type": "object"
},
"name": "create_quote_link",
"outputSchema": {
"additionalProperties": true,
"properties": {
"currency": {
"const": "ZAR",
"type": "string"
},
"delivery": {
"type": "string"
},
"expires_at": {
"type": "string"
},
"item_count": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"control_side": {
"type": "string"
},
"height_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"quantity",
"unit_price_zar",
"total_price_zar"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
},
"quote_id": {
"type": "string"
},
"quote_url": {
"type": "string"
},
"side_effects": {
"const": "none",
"type": "string"
},
"total_zar": {
"type": "number"
},
"vat_included": {
"type": "boolean"
}
},
"required": [
"quote_id",
"quote_url",
"items",
"item_count",
"total_zar",
"currency",
"expires_at",
"side_effects",
"note"
],
"type": "object"
}
},
{
"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": {
"properties": {
"mode": {
"description": "Which link goes in url: visualize (own-window visualiser), measure (measuring guide) or both (visualiser, the default). Both links are always returned.",
"enum": [
"measure",
"visualize",
"both"
],
"type": "string"
},
"product_id": {
"description": "Optional. Pre-select a product in the visualiser (e.g. roller-blockout, double-roller-zebra, outdoor-blinds).",
"type": "string"
}
},
"type": "object"
},
"name": "get_ar_visualizer_url",
"outputSchema": {
"additionalProperties": true,
"properties": {
"measure_url": {
"type": "string"
},
"note": {
"type": "string"
},
"product_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"supported_products": {
"items": {
"additionalProperties": true,
"properties": {
"label": {
"type": "string"
},
"product_id": {
"type": "string"
}
},
"required": [
"product_id",
"label"
],
"type": "object"
},
"type": "array"
},
"url": {
"type": "string"
},
"visualiser_url": {
"type": "string"
}
},
"required": [
"url",
"visualiser_url",
"measure_url",
"note"
],
"type": "object"
}
},
{
"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": {
"properties": {
"cart_id": {
"type": "string"
}
},
"required": [
"cart_id"
],
"type": "object"
},
"name": "get_cart",
"outputSchema": {
"additionalProperties": true,
"properties": {
"cart_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
{
"type": "null"
}
]
},
"expires_at": {
"type": "string"
},
"item_count": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"height_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"quantity",
"unit_price_zar",
"total_price_zar"
],
"type": "object"
},
"type": "array"
},
"total_zar": {
"type": "number"
},
"updated_at": {
"type": "string"
}
},
"required": [
"cart_id",
"items",
"item_count",
"total_zar",
"currency",
"customer",
"created_at",
"updated_at",
"expires_at"
],
"type": "object"
}
},
{
"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": {
"properties": {
"checkout_id": {
"type": "string"
}
},
"required": [
"checkout_id"
],
"type": "object"
},
"name": "get_checkout",
"outputSchema": {
"additionalProperties": true,
"properties": {
"ap2": {
"additionalProperties": true,
"properties": {
"merchant_authorization": {
"type": "string"
}
},
"required": [
"merchant_authorization"
],
"type": "object"
},
"checkout_id": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"item_count": {
"type": "number"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"drop_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_name": {
"type": "string"
},
"product_slug": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"next_step": {
"type": "string"
},
"payment_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"payment_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_zar": {
"type": "number"
}
},
"required": [
"checkout_id",
"status",
"total_zar",
"currency"
],
"type": "object"
}
},
{
"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": {
"properties": {
"order_date": {
"description": "ISO date of the order (e.g. '2026-05-18'). Defaults to today.",
"type": "string"
},
"postal_code": {
"description": "4-digit South African STREET postal code, e.g. 2196",
"type": "string"
},
"province": {
"description": "Optional province, e.g. Gauteng",
"type": "string"
},
"suburb": {
"description": "Optional suburb, e.g. Sandton",
"type": "string"
},
"town": {
"description": "Customer's town or city, e.g. 'Johannesburg'",
"type": "string"
},
"width_mm": {
"description": "Optional widest blind in mm (sets the parcel length)",
"type": "number"
}
},
"type": "object"
},
"name": "get_delivery_estimate",
"outputSchema": {
"additionalProperties": true,
"properties": {
"courier_high_risk_area": {
"type": "boolean"
},
"courier_service": {
"type": "string"
},
"delivery_after_dispatch": {
"type": "string"
},
"destination": {
"additionalProperties": true,
"properties": {
"postal_code": {
"type": "string"
},
"town": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"expedited_available": {
"type": "boolean"
},
"important": {
"type": "string"
},
"order_date": {
"type": "string"
},
"production_starts": {
"type": "string"
},
"production_working_days_max": {
"type": "number"
},
"production_working_days_min": {
"type": "number"
},
"summary": {
"type": "string"
},
"transit_note": {
"type": "string"
},
"transit_source": {
"enum": [
"courier_guy_quote",
"standard_range"
],
"type": "string"
},
"transit_working_days_max": {
"type": "number"
},
"transit_working_days_min": {
"type": "number"
}
},
"required": [
"production_working_days_min",
"production_working_days_max",
"transit_working_days_min",
"transit_working_days_max",
"delivery_after_dispatch",
"summary",
"important"
],
"type": "object"
}
},
{
"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": {
"properties": {
"customer_email": {
"type": "string"
},
"order_id": {
"type": "string"
}
},
"required": [
"order_id",
"customer_email"
],
"type": "object"
},
"name": "get_order",
"outputSchema": {
"additionalProperties": true,
"properties": {
"currency": {
"const": "ZAR",
"type": "string"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"drop_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_name": {
"type": "string"
},
"product_slug": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"lead_time": {
"type": "string"
},
"order_id": {
"type": "string"
},
"order_reference": {
"type": "string"
},
"order_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"paid_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"payment_status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_zar": {
"type": "number"
}
},
"required": [
"order_id",
"payment_status",
"total_zar",
"currency"
],
"type": "object"
}
},
{
"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": {
"properties": {
"order_total_zar": {
"description": "Optional. For future per-handler limit filtering.",
"type": "number"
}
},
"type": "object"
},
"name": "get_payment_methods",
"outputSchema": {
"additionalProperties": true,
"properties": {
"default_currency": {
"const": "ZAR",
"type": "string"
},
"handlers": {
"items": {
"additionalProperties": true,
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"supports": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"id",
"name",
"supports"
],
"type": "object"
},
"type": "array"
},
"note": {
"type": "string"
}
},
"required": [
"default_currency",
"handlers",
"note"
],
"type": "object"
}
},
{
"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": {
"properties": {
"colour": {
"description": "Optional bamboo colour for colour-specific tier pricing",
"type": "string"
},
"finish": {
"description": "Optional finish for aluminium products: Plain, Brushed, Woodgrain",
"type": "string"
},
"height_mm": {
"description": "Height/drop in millimetres (e.g. 1500)",
"type": "number"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id from search_catalog or lookup_catalog (e.g. roller-blockout)",
"type": "string"
},
"province": {
"description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.",
"type": "string"
},
"quantity": {
"description": "Number of blinds (default 1)",
"type": "number"
},
"width_mm": {
"description": "Width in millimetres (e.g. 1200)",
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm"
],
"type": "object"
},
"name": "get_price",
"outputSchema": {
"additionalProperties": true,
"properties": {
"contact": {
"additionalProperties": true,
"properties": {
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"note": {
"type": "string"
},
"whatsapp": {
"type": "string"
}
},
"required": [],
"type": "object"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"delivery": {
"type": "string"
},
"effective_height_mm": {
"type": "number"
},
"effective_width_mm": {
"type": "number"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"height_mm": {
"type": "number"
},
"lead_time": {
"type": "string"
},
"limits": {
"additionalProperties": true,
"properties": {},
"required": [],
"type": "object"
},
"minimum_charge_applied": {
"type": "boolean"
},
"next_step": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"vat_included": {
"type": "boolean"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"quantity",
"unit_price_zar",
"total_price_zar",
"currency",
"vat_included"
],
"type": "object"
}
},
{
"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": {
"properties": {
"product_id": {
"type": "string"
}
},
"required": [
"product_id"
],
"type": "object"
},
"name": "get_product",
"outputSchema": {
"additionalProperties": true,
"properties": {
"category": {
"type": "string"
},
"colour_count_in_stock": {
"type": "number"
},
"colours": {
"items": {
"additionalProperties": true,
"properties": {
"expected_restock": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"hex": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"in_stock": {
"type": "boolean"
},
"material": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"required": [
"name",
"in_stock"
],
"type": "object"
},
"type": "array"
},
"description": {
"type": "string"
},
"features": {
"items": {
"type": "string"
},
"type": "array"
},
"installation_type": {
"type": "string"
},
"materials": {
"items": {
"type": "string"
},
"type": "array"
},
"max_height_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"max_width_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
},
"schema_url": {
"type": "string"
},
"size_limits": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"availability_rule": {
"type": "string"
},
"combination_dependent": {
"type": "boolean"
},
"max_height_mm": {
"type": "number"
},
"max_width_mm": {
"type": "number"
},
"measurement_note": {
"type": "string"
},
"minimum_charge_height_mm": {
"type": "number"
},
"minimum_charge_width_mm": {
"type": "number"
},
"minimum_order_height_mm": {
"type": "number"
},
"minimum_order_width_mm": {
"type": "number"
},
"product_id": {
"type": "string"
},
"unit": {
"const": "mm",
"type": "string"
},
"validation_note": {
"type": "string"
},
"width_drop_frontier": {
"items": {
"additionalProperties": true,
"properties": {
"max_drop_mm": {
"type": "number"
},
"width_band_max_mm": {
"type": "number"
}
},
"required": [
"width_band_max_mm",
"max_drop_mm"
],
"type": "object"
},
"type": "array"
}
},
"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"
],
"type": "object"
},
{
"type": "null"
}
]
},
"starting_price_zar": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"suitable_for": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"product_id",
"name",
"category",
"colours",
"product_url"
],
"type": "object"
}
},
{
"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": {
"properties": {
"aesthetic": {
"type": "string"
},
"location": {
"type": "string"
},
"max_budget_zar": {
"type": "number"
},
"primary_concern": {
"enum": [
"blockout",
"heat",
"glare",
"moisture",
"privacy",
"security",
"automation"
],
"type": "string"
},
"room": {
"type": "string"
}
},
"required": [
"primary_concern"
],
"type": "object"
},
"name": "get_product_recommendation",
"outputSchema": {
"additionalProperties": true,
"properties": {
"handoff": {
"additionalProperties": true,
"properties": {
"product_family": {
"type": "string"
},
"reason": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"url",
"product_family",
"reason"
],
"type": "object"
},
"notes": {
"type": "string"
},
"recommendations": {
"items": {
"additionalProperties": true,
"properties": {
"currency": {
"const": "ZAR",
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"reason": {
"type": "string"
},
"shop_url": {
"type": "string"
},
"starting_price_zar_for_1m_x_1m": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"product_id",
"product_name",
"reason",
"starting_price_zar_for_1m_x_1m",
"currency",
"shop_url"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"recommendations"
],
"type": "object"
}
},
{
"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": {
"properties": {
"job_id": {
"type": "string"
}
},
"required": [
"job_id"
],
"type": "object"
},
"name": "get_visualiser_preview",
"outputSchema": {
"additionalProperties": true,
"properties": {
"checked": {
"type": "boolean"
},
"colour": {
"type": "string"
},
"error": {
"type": "string"
},
"image_mime": {
"type": "string"
},
"image_url": {
"type": "string"
},
"job_id": {
"type": "string"
},
"note": {
"type": "string"
},
"product_id": {
"type": "string"
},
"retry_after_seconds": {
"type": "number"
},
"status": {
"enum": [
"surveyed",
"drawing",
"done",
"failed"
],
"type": "string"
}
},
"required": [
"job_id",
"status"
],
"type": "object"
}
},
{
"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; all other South African locations route 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": {
"properties": {
"customer_name": {
"type": "string"
},
"location": {
"description": "City/suburb. Drives Duncan vs shop routing.",
"type": "string"
},
"message": {
"description": "Optional additional message to prefill",
"type": "string"
},
"product_context": {
"description": "e.g. 'roller blockout for bedroom'",
"type": "string"
}
},
"type": "object"
},
"name": "get_whatsapp_handoff",
"outputSchema": {
"additionalProperties": true,
"properties": {
"reason": {
"type": "string"
},
"recipient": {
"type": "string"
},
"recipient_phone": {
"type": "string"
},
"whatsapp_url": {
"type": "string"
}
},
"required": [
"whatsapp_url",
"recipient",
"recipient_phone",
"reason"
],
"type": "object"
}
},
{
"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": {
"properties": {
"category": {
"description": "roller | venetian | honeycomb | vertical | outdoor",
"type": "string"
},
"colour": {
"type": "string"
},
"max_height_mm": {
"type": "number"
},
"max_width_mm": {
"type": "number"
}
},
"type": "object"
},
"name": "lookup_catalog",
"outputSchema": {
"additionalProperties": true,
"properties": {
"results": {
"items": {
"additionalProperties": true,
"properties": {
"category": {
"type": "string"
},
"name": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
}
},
"required": [
"product_id",
"name",
"category",
"product_url"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"results",
"total"
],
"type": "object"
}
},
{
"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": {
"properties": {
"competitor_name": {
"description": "Name of the other retailer",
"type": "string"
},
"competitor_price_zar": {
"description": "Competitor's price in ZAR (incl. VAT)",
"type": "number"
},
"competitor_url": {
"description": "URL to competitor product page or quote",
"type": "string"
},
"customer_name": {
"description": "Customer name",
"type": "string"
},
"customer_whatsapp": {
"description": "Customer WhatsApp number for follow-up",
"type": "string"
},
"height_mm": {
"description": "Window height/drop in mm",
"type": "number"
},
"product_id": {
"description": "Product the customer wants to match (e.g. roller-blockout)",
"type": "string"
},
"width_mm": {
"description": "Window width in mm",
"type": "number"
}
},
"required": [
"product_id",
"competitor_price_zar"
],
"type": "object"
},
"name": "request_price_match",
"outputSchema": {
"additionalProperties": true,
"properties": {
"claim_summary": {
"additionalProperties": true,
"properties": {
"competitor": {
"type": "string"
},
"competitor_price_zar": {
"type": "string"
},
"dimensions": {
"type": "string"
},
"product_id": {
"type": "string"
}
},
"required": [
"product_id",
"dimensions",
"competitor",
"competitor_price_zar"
],
"type": "object"
},
"exclusions": {
"items": {
"type": "string"
},
"type": "array"
},
"message": {
"type": "string"
},
"note": {
"type": "string"
},
"success": {
"type": "boolean"
},
"whatsapp_url": {
"type": "string"
}
},
"required": [
"success",
"claim_summary",
"whatsapp_url",
"message",
"exclusions",
"note"
],
"type": "object"
}
},
{
"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": {
"properties": {
"customer_email": {
"description": "Customer's email address.",
"type": "string"
},
"customer_name": {
"description": "Customer's full name.",
"type": "string"
},
"customer_phone": {
"description": "Used as WhatsApp number",
"type": "string"
},
"order_ref": {
"description": "The order reference the swatches ship with. Required.",
"type": "string"
},
"product_interest": {
"description": "e.g. 'Roller Blockout' or 'Honeycomb'",
"type": "string"
},
"suburb": {
"description": "Optional delivery suburb",
"type": "string"
},
"swatch_codes": {
"description": "Optional specific colour codes (max 5)",
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"customer_name",
"customer_email",
"customer_phone",
"product_interest",
"order_ref"
],
"type": "object"
},
"name": "request_swatch",
"outputSchema": {
"additionalProperties": true,
"properties": {
"estimated_delivery_days": {
"additionalProperties": true,
"properties": {
"max": {
"type": "number"
},
"min": {
"type": "number"
}
},
"required": [
"min",
"max"
],
"type": "object"
},
"message": {
"type": "string"
},
"next_step": {
"type": "string"
},
"order_ref": {
"type": "string"
},
"policy": {
"type": "string"
},
"request_id": {
"type": "number"
},
"status": {
"type": "string"
},
"swatch_count": {
"type": "number"
}
},
"required": [
"status",
"message"
],
"type": "object"
}
},
{
"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": {
"properties": {
"query": {
"description": "Free-text query, e.g. 'blockout' or 'venetian'",
"type": "string"
}
},
"type": "object"
},
"name": "search_catalog",
"outputSchema": {
"additionalProperties": true,
"properties": {
"currency": {
"const": "ZAR",
"type": "string"
},
"results": {
"items": {
"additionalProperties": true,
"properties": {
"category": {
"type": "string"
},
"colour_count_in_stock": {
"type": "number"
},
"description": {
"type": "string"
},
"name": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_url": {
"type": "string"
}
},
"required": [
"product_id",
"name",
"category",
"description",
"product_url",
"colour_count_in_stock"
],
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"results",
"total",
"currency"
],
"type": "object"
}
},
{
"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": {
"properties": {
"colour": {
"description": "Exact in-stock colour name from get_product (for a Duo Roller, one of its listed colours)",
"type": "string"
},
"customer_name": {
"type": "string"
},
"image_base64": {
"description": "Or the photo itself, base64",
"type": "string"
},
"image_url": {
"description": "https URL of the customer's window or patio photo (JPEG, PNG or WebP, under 6 MB)",
"type": "string"
},
"product_id": {
"description": "Visualiser blind, e.g. roller-blockout, duo-roller, venetian-25mm-aluminium, honeycomb-blockout, outdoor-blinds, outdoor-blinds-pvc, outdoor-blinds-canvas",
"type": "string"
},
"whatsapp": {
"description": "Customer's South African WhatsApp number",
"type": "string"
}
},
"required": [
"product_id",
"colour",
"customer_name",
"whatsapp"
],
"type": "object"
},
"name": "start_visualiser_preview",
"outputSchema": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"job_id": {
"type": "string"
},
"next_step": {
"type": "string"
},
"note": {
"type": "string"
},
"product_id": {
"type": "string"
},
"remaining_previews": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
},
"windows_found": {
"type": "number"
}
},
"required": [
"job_id",
"status",
"product_id",
"colour",
"windows_found",
"next_step"
],
"type": "object"
}
},
{
"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": {
"properties": {
"cart_id": {
"type": "string"
},
"customer": {
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"email": {
"description": "Real customer email, checked before checkout creation",
"type": "string"
},
"name": {
"description": "Real customer name, checked before checkout creation",
"type": "string"
},
"phone": {
"description": "South African phone number, checked before checkout creation",
"type": "string"
}
},
"type": "object"
},
"indices": {
"description": "Item indices to remove (0-based) when op='remove'",
"items": {
"type": "number"
},
"type": "array"
},
"items": {
"items": {
"properties": {
"colour": {
"description": "Exact available colour; validate with configure_product before adding",
"minLength": 1,
"type": "string"
},
"finish": {
"description": "Optional pricing finish for aluminium Venetians",
"type": "string"
},
"height_mm": {
"description": "Actual ordered drop in millimetres",
"exclusiveMinimum": 0,
"type": "number"
},
"mount_type": {
"description": "Use inside for inside mount or outside for face fix",
"minLength": 1,
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"product_id": {
"description": "product_id returned by search_catalog or lookup_catalog",
"type": "string"
},
"product_name": {
"description": "Optional; server resolves the catalogue name",
"type": "string"
},
"quantity": {
"description": "Number of blinds; defaults to 1",
"type": "number"
},
"total_price_zar": {
"description": "Optional, ignored: server recalculates all totals",
"type": "number"
},
"unit_price_zar": {
"description": "Optional, ignored: server recalculates all prices",
"type": "number"
},
"width_mm": {
"description": "Actual ordered width in millimetres",
"exclusiveMinimum": 0,
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"colour",
"mount_type"
],
"type": "object"
},
"type": "array"
},
"op": {
"default": "set",
"enum": [
"add",
"remove",
"set",
"clear"
],
"type": "string"
}
},
"required": [
"cart_id"
],
"type": "object"
},
"name": "update_cart",
"outputSchema": {
"additionalProperties": true,
"properties": {
"cart_id": {
"type": "string"
},
"created_at": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"anyOf": [
{
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
{
"type": "null"
}
]
},
"expires_at": {
"type": "string"
},
"item_count": {
"type": "number"
},
"items": {
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"type": "string"
},
"finish": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"height_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price_zar": {
"type": "number"
},
"unit_price_zar": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"quantity",
"unit_price_zar",
"total_price_zar"
],
"type": "object"
},
"type": "array"
},
"total_zar": {
"type": "number"
},
"updated_at": {
"type": "string"
}
},
"required": [
"cart_id",
"items",
"item_count",
"total_zar",
"currency",
"customer",
"created_at",
"updated_at",
"expires_at"
],
"type": "object"
}
},
{
"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": {
"properties": {
"checkout_id": {
"type": "string"
},
"customer": {
"properties": {
"address": {
"type": "string"
},
"city": {
"type": "string"
},
"email": {
"description": "Real customer email, checked before checkout creation",
"type": "string"
},
"name": {
"description": "Real customer name, checked before checkout creation",
"type": "string"
},
"phone": {
"description": "South African phone number, checked before checkout creation",
"type": "string"
}
},
"type": "object"
},
"payment_method": {
"enum": [
"yoco",
"ozow"
],
"type": "string"
}
},
"required": [
"checkout_id"
],
"type": "object"
},
"name": "update_checkout",
"outputSchema": {
"additionalProperties": true,
"properties": {
"ap2": {
"additionalProperties": true,
"properties": {
"merchant_authorization": {
"type": "string"
}
},
"required": [
"merchant_authorization"
],
"type": "object"
},
"checkout_id": {
"type": "string"
},
"currency": {
"const": "ZAR",
"type": "string"
},
"customer": {
"additionalProperties": true,
"properties": {
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"email": {
"type": "string"
},
"name": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [],
"type": "object"
},
"item_count": {
"type": "number"
},
"items": {
"anyOf": [
{
"items": {
"additionalProperties": true,
"properties": {
"colour": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"drop_mm": {
"type": "number"
},
"mount_type": {
"type": "string"
},
"product_name": {
"type": "string"
},
"product_slug": {
"type": "string"
},
"quantity": {
"type": "number"
},
"total_price": {
"type": "number"
},
"unit_price": {
"type": "number"
},
"width_mm": {
"type": "number"
}
},
"required": [],
"type": "object"
},
"type": "array"
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
},
"next_step": {
"type": "string"
},
"payment_method": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"payment_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"provider_reference": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"total_zar": {
"type": "number"
}
},
"required": [
"checkout_id",
"status",
"total_zar",
"currency"
],
"type": "object"
}
},
{
"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 90mm; Duo Roller 100mm), 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": {
"properties": {
"colour": {
"description": "Optional exact colour name, checked for stock and width limits",
"type": "string"
},
"height_mm": {
"description": "Drop the customer will enter, in millimetres",
"type": "number"
},
"mount_type": {
"description": "inside (in the recess) or outside (face fix)",
"type": "string"
},
"no_drill": {
"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.",
"type": "boolean"
},
"opening_drop_mm": {
"description": "Optional, face fix only: drop of the opening itself",
"type": "number"
},
"opening_width_mm": {
"description": "Optional, face fix only: width of the opening itself",
"type": "number"
},
"product_id": {
"description": "product_id from search_catalog or lookup_catalog",
"type": "string"
},
"reveal_depth_mm": {
"description": "Optional depth of the recess in mm, needed for inside mounts and no-drill",
"type": "number"
},
"width_mm": {
"description": "Width the customer will enter, in millimetres",
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm"
],
"type": "object"
},
"name": "validate_measurement",
"outputSchema": {
"additionalProperties": true,
"properties": {
"advice": {
"items": {
"type": "string"
},
"type": "array"
},
"height_mm": {
"type": "number"
},
"inside_mount_min_reveal_mm": {
"type": "number"
},
"limits": {
"anyOf": [
{
"additionalProperties": true,
"properties": {},
"required": [],
"type": "object"
},
{
"type": "null"
}
]
},
"measure_guide_url": {
"type": "string"
},
"mount_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"next_step": {
"type": "string"
},
"no_drill": {
"type": "boolean"
},
"ok": {
"type": "boolean"
},
"problems": {
"items": {
"type": "string"
},
"type": "array"
},
"product_id": {
"type": "string"
},
"product_name": {
"type": "string"
},
"production_width_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"reveal_depth_mm": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
},
"width_mm": {
"type": "number"
}
},
"required": [
"product_id",
"width_mm",
"height_mm",
"ok",
"problems",
"warnings",
"advice",
"measure_guide_url",
"next_step"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:704fd1606e0145c1e56115d404eb54f2cf3d9137674becf95c6d9262e837240d | sha256sum