Custom Blinds Shop MCP server
online · 100% uptimeio.github.CustomBlinds/cb-shop·v1.0.0South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.
0 stars
Reviews
Write oneNobody has reviewed Custom Blinds Shop yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Custom Blinds Shop tools (26, 10 write)
write = sends, deletes, buys or postscancel_cartwrite actionFreePermanently 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.
cancel_checkoutwrite actionFreeAbort 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.
check_colour_stockFreeVerify 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.
complete_checkoutFreeGenerate 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.
configure_productFreeLock 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.
create_cartwrite actionFreeStart 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.
create_checkoutwrite actionFreePhase 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.
create_orderwrite actionFreeLegacy 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.
get_ar_visualizer_urlFreeReturns 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.
get_cartFreeRetrieve 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.
get_checkoutFreeRead 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.
get_delivery_estimateFreeExplain 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.
get_orderwrite actionFreeRetrieve 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.
get_payment_methodsFreeList 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.
get_priceFreeGet 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.
get_productFreeFetch 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.
get_product_recommendationFreeTranslate 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).
get_whatsapp_handoffFreeGenerate 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.
lookup_catalogFreePreferred 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.
request_price_matchwrite actionFreeSubmit 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.
request_swatchFreeLog 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.
search_catalogFreePreferred 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.
search_productsFreeLegacy 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.
submit_enquirywrite actionFreeLegacy 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.
update_cartwrite actionFreeModify 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.
update_checkoutwrite actionFreeUpdate 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.
Public scan report
scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 1283ms20/20
- Tool poisoning26 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 124 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Custom Blinds Shop compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 79/100
- higher than 58% of 48,255 servers
- Tools
- 26
- the typical server has 7
- Tools that change things
- 38%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote server answers 100%
- Response time
- 195 ms
- faster than 64% of 30,031 servers
What its tools let an agent do: 16 read · 3 create · 5 change · 2 delete
Install Custom Blinds Shop in Claude Code, Cursor or VS Code
claude mcp add --transport http cb-shop https://shop.customblinds.co.za/mcp
What the publisher says
From the Custom Blinds Shop repository's README, as published. We do not edit it. Read it on GitHub
Custom Blinds Shop MCP
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.
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.
Claude Desktop / Claude Code
{
"mcpServers": {
"custom-blinds-shop": {
"url": "https://shop.customblinds.co.za/mcp",
"transport": "streamable-http"
}
}
}Other clients
Point your MCP client at: https://shop.customblinds.co.za/mcp Transport: streamable-HTTP.
Verification
- Manifest: https://shop.customblinds.co.za/.well-known/mcp.json
- ARD catalog: https://customblinds.co.za/.well-known/ai-catalog.json
- Brochure MCP: https://customblinds.co.za/wp-json/cb/v1/mcp
- llms.txt: https://customblinds.co.za/llms.txt
About Custom Blinds
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.
- Brochure: https://customblinds.co.za
- Shop: https://shop.customblinds.co.za
- Issues: https://github.com/CustomBlinds/cb-shop-mcp/issues
License
MIT
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-10-24restoreC → Bscore 79
Custom Blinds Shop: common questions
- Is Custom Blinds Shop MCP server safe?
- Mostly: it is graded B (79/100). Read the Custom Blinds Shop safety report
- How do I install Custom Blinds Shop?
- It runs remotely at shop.customblinds.co.za. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Custom Blinds Shop need an API key?
- Yes. The registry entry asks for
Authorization. - Is Custom Blinds Shop maintained?
- The last commit was 135 days ago (2026-06-22). The latest release is v1.0.0.
- Is Custom Blinds Shop up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does Custom Blinds Shop compare with other MCP servers?
- safety score 79/100 (higher than 58% of 48,255 servers); tools 26 (the typical server has 7); tools that change things 38% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.