{"id":"za.co.customblinds/shop","slug":"za-co-customblinds-shop","title":"Custom Blinds","description":"Made-to-measure blinds in South Africa: prices, stock, quotes, delivery times, window previews.","version":"2.1.0","publisher":{"kind":"domain","id":"customblinds.co.za","label":"customblinds.co.za","url":"https://customblinds.co.za"},"website":"https://shop.customblinds.co.za/for-ai","repository":"","remotes":[{"type":"streamable-http","url":"https://shop.customblinds.co.za/mcp"}],"packages":[],"published":"2026-11-15","updated":"2026-11-15","status":"online","auth":"","latency_ms":1557,"checked":"2026-11-19","uptime":100,"checks":3,"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 w","read_only":true},{"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.","read_only":true},{"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_pr","read_only":true},{"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.","read_only":true},{"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.","read_only":true},{"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).","read_only":true},{"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.","read_only":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).","read_only":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.","read_only":true},{"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.","read_only":false},{"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.","read_only":false},{"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.","read_only":false},{"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.","read_only":true},{"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.","read_only":false},{"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","read_only":false},{"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.","read_only":false},{"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.","read_only":true},{"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 \"B","read_only":true},{"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","read_only":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.","read_only":true},{"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 (","read_only":true},{"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 h","read_only":true},{"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 ret","read_only":true},{"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). Ind","read_only":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.","read_only":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 ","read_only":true},{"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 ","read_only":true}],"server_info":{"name":"custom-blinds-shop","version":"2.0.0"},"category":"ecommerce","tags":["finance","communication","web-search"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-15","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/za-co-customblinds-shop/"}