Custom Blinds Shop
Server Details
South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- CustomBlinds/cb-shop-mcp
- GitHub Stars
- 0
- Server Listing
- Custom Blinds Shop MCP
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 27 tools
Most tools map cleanly to distinct purchase-flow stages: discovery, pricing, configuration, cart, checkout, payment, order status, and support. A few boundaries blur, especially check_colour_stock versus get_product's stock data, get_ar_visualizer_url versus the in-chat visualiser tools, and the various WhatsApp/handoff requests.
Tool names consistently use snake_case with a verb_noun or verb_object pattern, such as create_cart, update_checkout, get_product, and validate_measurement. The only minor spelling variation is visualizer in get_ar_visualizer_url versus visualiser elsewhere, but the overall convention is highly predictable.
With 27 tools, the surface exceeds the practical ceiling for comfortable agent selection and maintenance, even though many tools cover legitimate niche flows. The set would benefit from consolidation around visualiser, stock-checking, and WhatsApp handoff paths.
The core custom-blinds purchase lifecycle is well covered: catalog search, product details, measurement validation, pricing, configuration, cart, checkout, payment methods, delivery estimates, quotes, visual previews, and order lookup. Minor gaps remain around paid-order cancellation/refunds and retrieving or managing previously created quote links, though handoff tools mitigate these.
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. 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. Awnings, shutters, shadeports and Ziptrak, named in product_context, route to Duncan Kane from anywhere in South Africa. Everything else routes to the shop WhatsApp (+27760228410), WhatsApp only, no voice calls. Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.
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 80mm; Duo Roller 115mm), no-drill rules (inside only, at least 50mm reveal on rollers and 40mm on 25mm venetians, 2000mm max width, 1500mm on 25mm venetians), face-fix sizing (add 100mm each side and 100mm above and below) and the width we deduct when making an inside mount. Changes nothing and returns no price.
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
Design homes with your AI: floor plans, furniture, joinery, lighting and photos, live.
AI-native product and pricing configuration (CPQ) for manufacturers, every rule checked.
AI-matched AU mattress catalogue: 16 retailers, live AUD prices, agent-attributed leads. No auth.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
Related MCP Servers
- AlicenseAqualityDmaintenanceKlarna-style product discovery for AI shopping agents. Makes product catalogs machine-readable so AI agents can search, compare, and purchase products programmatically.637 PyPIMIT
- FlicenseNot gradedqualityBmaintenanceEnables AI agents to search enterprise Auto-ID products and exact SKUs, read live stock and current pricing, and explore variants, accessories, consumables and support relationships through a public read-only endpoint. It also surfaces manuals, firmware, drivers and other verified technical resources from the vendor's support center.-
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to browse product catalogs, search products with filters, and initiate checkouts, generating order summaries and checkout URLs.-
- AlicenseBqualityBmaintenanceAI assistant tools for building high-converting immersive commerce showrooms from an existing e-commerce catalog. Built on Mantis XR's production immersive-commerce platform, used by Fortune 500 brands including New Balance, with deployments spanning the Paris 2024 Olympics, MLB (Chicago Cubs), NHL (St. Louis Blues), and the Premier League (Burnley FC and other clubs).1465 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.