Custom Blinds
Server Details
Made-to-measure blinds in South Africa: prices, stock, quotes, delivery times, window previews.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 27 tools
Most tools occupy distinct resource/action slots (catalog vs product vs price vs cart vs checkout vs order), and descriptions actively steer between similar ones. A few pairs still blur: search_catalog vs lookup_catalog (free-text vs filters), check_colour_stock vs get_product (both surface stock), and the three visualiser tools whose boundaries require close reading to separate.
Every tool follows a consistent snake_case verb_noun convention (create_cart, get_order, update_checkout, cancel_checkout, validate_measurement). Prefix families (get_*, create_*, update_*, cancel_*, request_*) are applied predictably across resources.
27 tools is heavy for a blinds retail server and sits at the upper edge of what an agent can hold in working memory. Several could be consolidated (check_colour_stock into get_product, get_ar_visualizer_url alongside the in-chat preview tools), though most do map to a real workflow step.
The surface covers the full purchase lifecycle: discovery, pricing, configuration, measurement validation, cart, checkout, payment, order status, quotes, visualiser, swatch and human handoff. Gaps are secondary: no order cancellation/refund, no order history or shipment tracking, and no returns flow.
Available Tools
27 toolscancel_cartCancel a cartADestructiveInspect
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.
Inputs: cart_id (required). Returns: cart_id, cancelled
cancel_checkoutCancel checkoutADestructiveInspect
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.
Inputs: checkout_id (required). Returns: status, checkout_id
check_colour_stockCheck colour stockARead-onlyInspect
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).
Inputs: product_id (required), colour_name (required). Returns: found, colour, message, in_stock, +6 more
complete_checkoutGet the payment linkADestructiveInspect
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.
Inputs: checkout_id (required), payment_method. Returns: ap2, items, status, message, +9 more
configure_productConfigure a blindARead-onlyInspect
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).
Inputs: colour (required), width_mm (required), height_mm (required), mount_type (required), +5 more. Returns: colour, finish, limits, contact, +19 more
create_cartCreate a cartAInspect
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).
Inputs: items, customer. Returns: items, cart_id, currency, customer, +5 more
create_checkoutStart checkoutADestructiveInspect
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.
Inputs: items, cart_id, customer, payment_method. Returns: ap2, items, status, message, +9 more
create_quote_linkCreate a shareable quoteAInspect
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.
Inputs: items (required). Returns: note, items, currency, delivery, +7 more
get_ar_visualizer_urlGet the web visualiser linkARead-onlyInspect
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.
Inputs: mode, product_id. Returns: url, note, product_id, measure_url, +2 more
get_cartView a cartARead-onlyInspect
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.
Inputs: cart_id (required). Returns: items, cart_id, currency, customer, +5 more
get_checkoutView checkoutARead-onlyInspect
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.
Inputs: checkout_id (required). Returns: ap2, items, status, message, +9 more
get_delivery_estimateEstimate lead time and deliveryARead-onlyInspect
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.
Inputs: town, suburb, province, width_mm, +2 more. Returns: summary, important, order_date, destination, +11 more
get_orderCheck an orderARead-onlyInspect
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.
Inputs: order_id (required), customer_email (required). Returns: items, paid_at, currency, order_id, +5 more
get_payment_methodsList payment methodsARead-onlyInspect
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.
Inputs: order_total_zar. Returns: note, handlers, default_currency
get_priceGet price for a sizeARead-onlyInspect
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.
Inputs: width_mm (required), height_mm (required), product_id (required), colour, +4 more. Returns: finish, limits, contact, currency, +14 more
get_productGet product detailsARead-onlyInspect
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).
Inputs: product_id (required). Returns: name, colours, category, features, +12 more
get_product_recommendationRecommend a blindARead-onlyInspect
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).
Inputs: primary_concern (required), room, location, aesthetic, +1 more. Returns: notes, handoff, recommendations
get_visualiser_previewGet the window previewAInspect
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.
Inputs: job_id (required). Returns: note, error, colour, job_id, +6 more
get_whatsapp_handoffHand over to WhatsAppARead-onlyInspect
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.
Inputs: message, location, customer_name, product_context. Returns: reason, recipient, whatsapp_url, recipient_phone
lookup_catalogFilter the catalogueARead-onlyInspect
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.
Inputs: colour, category, max_width_mm, max_height_mm. Returns: total, results
request_price_matchPrepare a price-match requestARead-onlyInspect
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.
Inputs: product_id (required), competitor_price_zar (required), width_mm, height_mm, +4 more. Returns: note, message, success, exclusions, +2 more
request_swatchRequest fabric swatchesAInspect
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.
Inputs: order_ref (required), customer_name (required), customer_email (required), customer_phone (required), +3 more. Returns: policy, status, message, next_step, +4 more
search_catalogSearch the blinds catalogueARead-onlyInspect
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.
Inputs: query. Returns: total, results, currency
start_visualiser_previewStart a window or patio previewAInspect
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.
Inputs: colour (required), whatsapp (required), product_id (required), customer_name (required), +2 more. Returns: note, colour, job_id, status, +4 more
update_cartUpdate a cartADestructiveInspect
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.
Inputs: cart_id (required), op, items, indices, +1 more. Returns: items, cart_id, currency, customer, +5 more
update_checkoutUpdate checkout detailsADestructiveInspect
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.
Inputs: checkout_id (required), customer, payment_method. Returns: ap2, items, status, message, +9 more
validate_measurementCheck blind measurementsARead-onlyInspect
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.
Inputs: width_mm (required), height_mm (required), product_id (required), colour, +5 more. Returns: ok, advice, limits, no_drill, +12 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
South African studio: services and rand prices, bundle estimates, guides and order requests.
Discover and book wine tastings at 185 South African wine estates. Free for guests and wineries.
Send WhatsApp, SMS and email for South African businesses: contacts, campaigns, templates, webhooks
Find local businesses across Cape Town, the Winelands and the rest of the Western Cape. Search by service or name, see menus and price lists in rand, then start a booking, quote or order in WRDO.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides a deterministic soft furnishing budget catalog and calculation tool for estimating soft decoration costs by style, rooms, and tier with zero external API dependencies.-

SmartCutofficial
FlicenseNot gradedqualityCmaintenanceSmartCut is a hosted cutting-optimisation API. It turns a list of parts and available stock into machine-ready cutting patterns for sheet materials (plywood, MDF, glass, plastic, sheet metal), linear stock (timber, bar, pipe, extrusion) and roll goods. Guillotine and true-shape nesting modes, with grain direction, per-part orientation locks, edge banding, blade kerf and stock trim.3-- FlicenseAqualityBmaintenanceParametric price benchmarking for engineering and procurement trade-offs. Agentic first, runs on your data, stays on your machine.122-
- AlicenseBqualityDmaintenanceCompare parcel and letter delivery prices across 60+ carriers in 27 European countries.1MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.