Custom Blinds Shop

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Custom Blinds Shop": {
      "url": "https://shop.customblinds.co.za/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (26)

• search_products

  Legacy discovery, retained for backward compatibility. Prefer search_catalog / lookup_catalog, then get_product. Filters by blind type, colour or maximum dimensions. Returns products with id (not product_id), name, description, features and in-stock colour count. Pass that id as product_id to get_price or configure_product.

  Parameters:

  • type — string — Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor
  • colour — string — Colour name to search for (partial match)
  • province — string — Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
  • max_width_mm — number — Maximum width in millimetres the product supports
  • max_height_mm — number — Maximum height/drop in millimetres the product supports

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_price

  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.

  Parameters:

  • product_id (required) — string — product_id from search_catalog or lookup_catalog (e.g. roller-blockout)
  • width_mm (required) — number — Width in millimetres (e.g. 1200)
  • height_mm (required) — number — Height/drop in millimetres (e.g. 1500)
  • colour — string — Optional bamboo colour for colour-specific tier pricing
  • finish — string — Optional finish for aluminium products: Plain, Brushed, Woodgrain
  • province — string — Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
  • quantity — number — Number of blinds (default 1)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • product_id (required) — string — product_id from search_catalog or lookup_catalog
  • width_mm (required) — number — Width in millimetres
  • height_mm (required) — number — Height/drop in millimetres
  • colour (required) — string — Colour name (must match available colours)
  • mount_type (required) — string — Use inside (recess) or outside (face-fix); handler requires a nonempty value
  • finish — string — Optional finish for aluminium venetians
  • province — string — Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.
  • quantity — number — Number of blinds (default 1)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • product_config (required) — object — Product configuration from configure_product
  • customer_name (required) — string — Customer full name
  • customer_email (required) — string — Customer email address
  • customer_phone (required) — string — Customer phone number
  • message (required) — string — Required enquiry message; at least 10 characters after trimming

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • items (required) — array — Array of configured blind items
  • customer_name (required) — string — Customer full name
  • customer_email (required) — string — Customer email address
  • customer_phone (required) — string — Customer phone number
  • customer_city — string — Delivery city
  • payment_method — string — Yoco card or Ozow instant EFT
  • customer_address — string — Delivery address

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• search_catalog

  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.

  Parameters:

  • query — string — Free-text query, e.g. 'blockout' or 'venetian'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• lookup_catalog

  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.

  Parameters:

  • colour — string
  • category — string — roller | venetian | honeycomb | vertical | outdoor
  • max_width_mm — number
  • max_height_mm — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_product

  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:

  • product_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • items — array — Optional configured items; all submitted prices are ignored
  • customer — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • cart_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • cart_id (required) — string
  • op — string
  • items — array
  • indices — array — Item indices to remove (0-based) when op='remove'
  • customer — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • cart_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• create_checkout

  Phase 1 of 2 in the purchase flow. Convert a cart (or inline items + customer) into a checkout. The customer's real name, email, mobile number and delivery address are required; placeholder or test details are refused. Returns checkout_id. No payment link is minted yet, call complete_checkout for that. Use update_checkout to correct customer details before finalising.

  Parameters:

  • items — array
  • cart_id — string — Either cart_id or items required
  • customer — object
  • payment_method — string — Default 'yoco'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_checkout

  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.

  Parameters:

  • checkout_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_checkout

  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.

  Parameters:

  • checkout_id (required) — string
  • customer — object
  • payment_method — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• complete_checkout

  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.

  Parameters:

  • checkout_id (required) — string
  • payment_method — string — Overrides any value set in create_checkout/update_checkout

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • checkout_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • order_id (required) — string
  • customer_email (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • product_id (required) — string
  • colour_name (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• request_swatch

  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). Custom Blinds does not post individual swatches or off-cuts. For orders over R8,000 the customer can ask for the full sample book via WhatsApp; if nothing suits, full refund with no fees. Never quote a sample-book price or courier cost.

  Parameters:

  • customer_name (required) — string
  • customer_email (required) — string
  • customer_phone (required) — string — Used as WhatsApp number
  • product_interest (required) — string — e.g. 'Roller Blockout' or 'Honeycomb'
  • order_ref (required) — string — The order reference the swatches ship with. Required.
  • suburb — string — Optional delivery suburb
  • swatch_codes — array — Optional specific colour codes (max 5)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • order_total_zar — number — Optional. For future per-handler limit filtering.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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 for a free in-home consultation, booked on the same WhatsApp line (+27760228410); all other South African locations route to that line too (+27760228410). It is WhatsApp only, no voice calls. Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.

  Parameters:

  • message — string — Optional additional message to prefill
  • location — string — City/suburb. Drives Duncan vs shop routing.
  • customer_name — string
  • product_context — string — e.g. 'roller blockout for bedroom'

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• 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:

  • primary_concern (required) — string
  • room — string
  • location — string
  • aesthetic — string
  • max_budget_zar — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_ar_visualizer_url

  Returns the link to the Custom Blinds measuring guide when a customer is unsure how to measure. There is no AR tool: the guide shows how to measure for an inside (recess) or outside (face fix) fit in two minutes, and a customer who is still unsure can order with best guess sizes, receive a free tape measure and confirm before production starts.

  Parameters:

  • mode — string — Which tool to surface. Default: both.
  • product_id — string — Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_delivery_estimate

  Explain the production lead time for a new order. Production takes 5 to 7 working days, excluding transit times and outside peak seasons. Returns dispatch_date, production_days, and a plain-language summary safe to share with the customer. Never quote a final delivery date. Call this when a customer asks 'when will it arrive?' to give an honest production timeline.

  Parameters:

  • order_date — string — ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• request_price_match

  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, or out-of-stock items. Requires product_id and competitor_price_zar at minimum.

  Parameters:

  • product_id (required) — string — Product the customer wants to match (e.g. roller-blockout)
  • competitor_price_zar (required) — number — Competitor's price in ZAR (incl. VAT)
  • width_mm — number — Window width in mm
  • height_mm — number — Window height/drop in mm
  • customer_name — string — Customer name
  • competitor_url — string — URL to competitor product page or quote
  • competitor_name — string — Name of the competitor (e.g. 'Blind Empire')
  • customer_whatsapp — string — Customer WhatsApp number for follow-up

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.