# Custom Blinds Shop (remote · shop.customblinds.co.za)

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

- Trust score: 65/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `shop.customblinds.co.za`: 65/100 (this document), [markdown](https://verifymcp.io/servers/customblinds-cb-shop/shop.md), [page](https://verifymcp.io/servers/customblinds-cb-shop/shop)

## Channel facts

- Endpoint: `https://shop.customblinds.co.za/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 26 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3148 tokens (~121/item across 26 items; 26 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 89/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 66% of tool parameters carry a description.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http customblinds-cb-shop https://shop.customblinds.co.za/mcp
```

### Codex

```toml
[mcp_servers.customblinds-cb-shop]
url = "https://shop.customblinds.co.za/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "customblinds-cb-shop": {
      "type": "remote",
      "url": "https://shop.customblinds.co.za/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add customblinds-cb-shop --url https://shop.customblinds.co.za/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  customblinds-cb-shop:
    url: "https://shop.customblinds.co.za/mcp"
```

### Other

```json
{
  "mcpServers": {
    "customblinds-cb-shop": {
      "type": "http",
      "url": "https://shop.customblinds.co.za/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 64, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 63, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 62, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 62, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 60, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 60)

First indexed and scored.

## MCP tools (26)

### `search_products` (~188 tokens)

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.

Input parameters:

- `colour` (string): Colour name to search for (partial match)
- `max_height_mm` (number): Maximum height/drop in millimetres the product supports
- `max_width_mm` (number): Maximum width in millimetres the product supports
- `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.
- `type` (string): Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor

### `get_price` (~206 tokens)

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.

Input parameters:

- `finish` (string): Optional finish for aluminium products: Plain, Brushed, Woodgrain
- `height_mm` (number, required): Height/drop in millimetres (e.g. 1500)
- `product_id` (string, required): Product ID from search_products (e.g. roller-blockout, venetian-25mm-aluminium)
- `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)
- `width_mm` (number, required): Width in millimetres (e.g. 1200)

### `configure_product` (~207 tokens)

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.

Input parameters:

- `colour` (string, required): Colour name (must match available colours)
- `finish` (string): Optional finish for aluminium venetians
- `height_mm` (number, required): Height/drop in millimetres
- `mount_type` (string, required): Mount type: inside (recess) or outside (face-fix)
- `product_id` (string, required): Product ID from search_products
- `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)
- `width_mm` (number, required): Width in millimetres

### `submit_enquiry` (~142 tokens)

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.

Input parameters:

- `customer_email` (string, required): Customer email address
- `customer_name` (string, required): Customer full name
- `customer_phone` (string, required): Customer phone number
- `message` (string): Additional message or questions from the customer
- `product_config` (object, required): Product configuration from configure_product

### `create_order` (~154 tokens)

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.

Input parameters:

- `customer_address` (string): Delivery address
- `customer_city` (string): Delivery city
- `customer_email` (string, required): Customer email address
- `customer_name` (string, required): Customer full name
- `customer_phone` (string, required): Customer phone number
- `items` (array, required): Array of configured blind items

### `search_catalog` (~95 tokens)

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.

Input parameters:

- `query` (string): Free-text query, e.g. 'blockout' or 'venetian'

### `lookup_catalog` (~114 tokens)

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.

Input parameters:

- `category` (string): roller | venetian | honeycomb | vertical | outdoor
- `colour` (string)
- `max_height_mm` (number)
- `max_width_mm` (number)

### `get_product` (~76 tokens)

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.

Input parameters:

- `product_id` (string, required)

### `create_cart` (~91 tokens)

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.

Input parameters:

- `customer` (object): Optional customer details
- `items` (array): Optional initial items (configured blinds)

### `get_cart` (~66 tokens)

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.

Input parameters:

- `cart_id` (string, required)

### `update_cart` (~135 tokens)

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.

Input parameters:

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

### `cancel_cart` (~65 tokens)

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.

Input parameters:

- `cart_id` (string, required)

### `create_checkout` (~111 tokens)

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.

Input parameters:

- `cart_id` (string): Either cart_id or items required
- `customer` (object)
- `items` (array)
- `payment_method` (string): Default 'yoco'

### `get_checkout` (~69 tokens)

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.

Input parameters:

- `checkout_id` (string, required)

### `update_checkout` (~81 tokens)

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.

Input parameters:

- `checkout_id` (string, required)
- `customer` (object)
- `payment_method` (string)

### `complete_checkout` (~108 tokens)

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.

Input parameters:

- `checkout_id` (string, required)
- `payment_method` (string): Overrides any value set in create_checkout/update_checkout

### `cancel_checkout` (~63 tokens)

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.

Input parameters:

- `checkout_id` (string, required)

### `get_order` (~80 tokens)

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.

Input parameters:

- `customer_email` (string, required)
- `order_id` (string, required)

### `check_colour_stock` (~90 tokens)

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.

Input parameters:

- `colour_name` (string, required)
- `product_id` (string, required)

### `request_swatch` (~156 tokens)

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.

Input parameters:

- `customer_email` (string, required)
- `customer_name` (string, required)
- `customer_phone` (string, required): Used as WhatsApp number
- `product_interest` (string, required): e.g. 'Roller Blockout' or 'Honeycomb'
- `suburb` (string): Optional delivery suburb
- `swatch_codes` (array): Optional specific colour codes (max 5)

### `get_payment_methods` (~85 tokens)

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.

Input parameters:

- `order_total_zar` (number): Optional. For future per-handler limit filtering.

### `get_whatsapp_handoff` (~151 tokens)

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.

Input parameters:

- `customer_name` (string)
- `location` (string): City/suburb. Drives Duncan vs shop routing.
- `message` (string): Optional additional message to prefill
- `product_context` (string): e.g. 'roller blockout for bedroom'

### `get_product_recommendation` (~134 tokens)

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).

Input parameters:

- `aesthetic` (string)
- `location` (string)
- `max_budget_zar` (number)
- `primary_concern` (string, required)
- `room` (string)

### `get_ar_visualizer_url` (~144 tokens)

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.

Input 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).

### `get_delivery_estimate` (~121 tokens)

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.

Input parameters:

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

### `request_price_match` (~216 tokens)

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.

Input parameters:

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

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/customblinds-cb-shop/shop#diagnostics

## Score history

- 2026-08-03: 65
- 2026-08-02: 64
- 2026-08-01: 64
- 2026-07-31: 63
- 2026-07-30: 62
- 2026-07-29: 62
- 2026-07-28: 61
- 2026-07-27: 60
- 2026-07-26: 60

## Links

- Remote endpoint: https://shop.customblinds.co.za/mcp
- Repository: https://github.com/CustomBlinds/cb-shop-mcp
- Changelog RSS feed: https://verifymcp.io/servers/customblinds-cb-shop/shop/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/customblinds-cb-shop/shop/changelog.json
- HTML version of this page: https://verifymcp.io/servers/customblinds-cb-shop/shop