South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.
AI-transactable catalogue of blinds, shutters, and awnings with live South African pricing.
Captured live from the server via tools/list.
search_products
Use when the customer hasn't specified a product ID yet. Filters by blind type (roller, venetian, honeycomb, vertical, outdoor), colour name, or maximum window dimensions in mm. Returns product_id, name, description, features, and in-stock colour count. Pass the product_id to get_price or configure_product as the next step.
Parameters (5)
typestring
Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor
colourstring
Colour name to search for (partial match)
max_width_mmnumber
Maximum width in millimetres the product supports
max_height_mmnumber
Maximum height/drop in millimetres the product supports
provincestring
Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
get_price
Get an exact ZAR price for a product at specific dimensions. Requires product_id (from search_products or lookup_catalog), width_mm, and height_mm. Returns unit_price_zar and total_price_zar (VAT included). Call configure_product next to lock in colour and mount type before creating a cart.
Parameters (6)
product_idstringrequired
Product ID from search_products (e.g. roller-blockout, venetian-25mm-aluminium)
width_mmnumberrequired
Width in millimetres (e.g. 1200)
height_mmnumberrequired
Height/drop in millimetres (e.g. 1500)
finishstring
Optional finish for aluminium products: Plain, Brushed, Woodgrain
quantitynumber
Number of blinds (default 1)
provincestring
Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
configure_product
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.
Parameters (8)
product_idstringrequired
Product ID from search_products
width_mmnumberrequired
Width in millimetres
height_mmnumberrequired
Height/drop in millimetres
colourstringrequired
Colour name (must match available colours)
mount_typestringrequired
Mount type: inside (recess) or outside (face-fix)
finishstring
Optional finish for aluminium venetians
quantitynumber
Number of blinds (default 1)
provincestring
Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
submit_enquiry
Legacy auth-required tool — prefer the open UCP flow (create_cart → create_checkout → complete_checkout) for credentialless checkout. Use submit_enquiry only when the customer wants a sales team follow-up by email rather than paying online. Requires Bearer token. Pass a configure_product output plus customer name, email, and phone. Team responds within 24 hours.
Parameters (5)
product_configobjectrequired
Product configuration from configure_product
customer_namestringrequired
Customer full name
customer_emailstringrequired
Customer email address
customer_phonestringrequired
Customer phone number
messagestring
Additional message or questions from the customer
create_order
Legacy auth-required tool — prefer the open UCP flow (create_cart → create_checkout → complete_checkout) which needs no credentials. Use create_order only if you hold a Bearer token and want a single-call path to a payment link. All item prices are re-verified server-side against the live pricing engine — agent-supplied prices are ignored. Returns a Yoco or Ozow payment_url.
Parameters (6)
itemsarrayrequired
Array of configured blind items
customer_namestringrequired
Customer full name
customer_emailstringrequired
Customer email address
customer_phonestringrequired
Customer phone number
customer_addressstring
Delivery address
customer_citystring
Delivery city
search_catalog
Free-text search across the full catalogue — use for open queries like 'blockout for bedroom' or 'wood venetian'. Returns id, name, category, description, and product_url. For filtering by category, colour, or dimensions use lookup_catalog instead. Pass the returned id to get_product or get_price.
Parameters (1)
querystring
Free-text query, e.g. 'blockout' or 'venetian'
lookup_catalog
Structured catalogue filter: narrow by category (roller | venetian | honeycomb | vertical | outdoor), colour name, max_width_mm, or max_height_mm. Ideal when the customer has stated a blind type. Returns matching products with id and product_url. Use search_catalog for open-ended natural language queries.
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.
Parameters (1)
product_idstringrequired
create_cart
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.
Parameters (2)
itemsarray
Optional initial items (configured blinds)
customerobject
Optional customer details
get_cart
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.
Parameters (1)
cart_idstringrequired
update_cart
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.
Parameters (5)
cart_idstringrequired
opstring
itemsarray
indicesarray
Item indices to remove (0-based) when op='remove'
customerobject
cancel_cart
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.
Parameters (1)
cart_idstringrequired
create_checkout
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.
Parameters (4)
cart_idstring
Either cart_id or items required
itemsarray
customerobject
payment_methodstring
Default 'yoco'
get_checkout
Poll a checkout by checkout_id. Returns status (pending | paid | cancelled), full item list, customer details, and payment_url if already minted. Use to verify customer details before calling complete_checkout, or to retrieve the payment_url if complete_checkout was already called.
Parameters (1)
checkout_idstringrequired
update_checkout
Correct customer details (name, email, phone, address) or switch payment_method (yoco | ozow) on an unpaid checkout before calling complete_checkout. Returns the updated checkout state. Raises an error if the checkout is already paid or cancelled.
Parameters (3)
checkout_idstringrequired
customerobject
payment_methodstring
complete_checkout
Phase 2 of 2. Finalise a checkout and mint the payment link — Yoco for card payments or Ozow for instant EFT. Returns payment_url to share with the customer. Payment confirmation arrives via webhook; poll get_order afterwards to confirm paid status. Once called, the checkout is locked — use cancel_checkout to abort if the customer changes their mind before paying.
Parameters (2)
checkout_idstringrequired
payment_methodstring
Overrides any value set in create_checkout/update_checkout
cancel_checkout
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.
Parameters (1)
checkout_idstringrequired
get_order
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.
Parameters (2)
order_idstringrequired
customer_emailstringrequired
check_colour_stock
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.
Parameters (2)
product_idstringrequired
colour_namestringrequired
request_swatch
Register up to 5 colour swatches to be dispatched with the customer's order. Swatches ship at order placement only — they are NOT sent as a standalone postal sample before purchase. Capped at 5 codes per order. If the customer asks for swatches before ordering, explain they ship with the blind and guide them to place their order first.
Parameters (6)
customer_namestringrequired
customer_emailstringrequired
customer_phonestringrequired
Used as WhatsApp number
product_intereststringrequired
e.g. 'Roller Blockout' or 'Honeycomb'
suburbstring
Optional delivery suburb
swatch_codesarray
Optional specific colour codes (max 5)
get_payment_methods
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.
Parameters (1)
order_total_zarnumber
Optional. For future per-handler limit filtering.
get_whatsapp_handoff
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 (+27795235407) for free in-home consultation; all other South African locations route to the online shop line (+27760228410). Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.
Parameters (4)
customer_namestring
product_contextstring
e.g. 'roller blockout for bedroom'
messagestring
Optional additional message to prefill
locationstring
City/suburb. Drives Duncan vs shop routing.
get_product_recommendation
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. Security concern routes to brochure MCP (Garden Route customers only).
Parameters (5)
primary_concernstringrequired
roomstring
locationstring
max_budget_zarnumber
aestheticstring
get_ar_visualizer_url
Surface the AR measurement tool or product visualizer when a customer wants to measure their window or preview a blind in their room. The AR tool uses a phone camera and an A4 page as a reference scale to measure window dimensions. The visualizer renders the selected blind in a customer-uploaded room photo. Set mode to 'measure', 'visualize', or 'both'. Optionally pre-select a product_id.
Parameters (2)
product_idstring
Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood).
modestring
Which tool to surface. Default: both.
get_delivery_estimate
Estimate when a new order will be dispatched. Production is 5 working days (Mon–Fri, excluding South African public holidays). Returns dispatch_date, production_days, and a plain-language summary safe to share with the customer. Never quote a final delivery date — The Courier Guy transit time varies by location. Call this when a customer asks 'when will it arrive?' to give an honest production timeline.
Parameters (1)
order_datestring
ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today.
request_price_match
Submit a price match claim when the customer has found the same blind cheaper 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: Blinds Direct (same supplier), clearance or flash-sale prices, or out-of-stock items. Requires product_id and competitor_price_zar at minimum.
Parameters (8)
product_idstringrequired
Product the customer wants to match (e.g. roller-blockout)
South Africa's first AI-transactable window covering catalogue. Lets MCP-compatible AI agents (Claude, ChatGPT, Cowork, Cursor) search the Custom Blinds catalogue, get live ZAR pricing, configure made-to-measure blinds, and take a customer all the way from product discovery to a Yoco or Ozow payment link — direct from shop.customblinds.co.za. The full purchase flow is open and needs no credentials.
<!-- mcp-name: io.github.CustomBlinds/cb-shop -->
What it does
This is the transactional node of a two-node system. The shop MCP handles search, pricing, configuration, cart, checkout and payment. Product education and design advice live on the brochure MCP at customblinds.co.za. An agent can start cold on the brochure for guidance, then hand off to this shop MCP to complete the order.
The full UCP purchase flow is open (no authentication): search the catalogue, get exact VAT-included ZAR pricing, configure a blind, build a cart, create a checkout, and mint a Yoco or Ozow payment link without any credentials. Twenty-seven tools are exposed.
submit_enquiry, create_order — only needed for an email follow-up or a single-call order path; the open checkout flow above is preferred
Payment is by Yoco (card) or Ozow (instant EFT). All prices are in ZAR with VAT included. Legacy bearer tokens are issued on request — contact sales@customblinds.co.za.
Connection
This is a remote MCP server — no install required.
Custom Blinds Shutters & Awnings — established 2010, based in Knysna on the Garden Route, South Africa. Founded by Duncan Kane, 20+ years industry experience. National online ordering with free delivery; professional installation across the Garden Route.
