MCP.Market

Custom Blinds Shop MCP server

online · 100% uptime
by CustomBlinds·io.github.CustomBlinds/cb-shop·v1.0.0

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

B79/100grade B
What users say
No reviews yet
Be the first
Safety scan
B79/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody 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 posts
  • cancel_cartwrite actionFree

    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.

  • cancel_checkoutwrite actionFree

    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.

  • check_colour_stockFree

    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.

  • complete_checkoutFree

    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.

  • configure_productFree

    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.

  • create_cartwrite actionFree

    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.

  • create_checkoutwrite actionFree

    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.

  • create_orderwrite actionFree

    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.

  • get_ar_visualizer_urlFree

    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.

  • get_cartFree

    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.

  • get_checkoutFree

    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.

  • get_delivery_estimateFree

    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.

  • get_orderwrite actionFree

    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.

  • get_payment_methodsFree

    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.

  • get_priceFree

    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.

  • get_productFree

    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.

  • get_product_recommendationFree

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

  • get_whatsapp_handoffFree

    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.

  • lookup_catalogFree

    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.

  • request_price_matchwrite actionFree

    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.

  • request_swatchFree

    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.

  • search_catalogFree

    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.

  • search_productsFree

    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.

  • submit_enquirywrite actionFree

    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.

  • update_cartwrite actionFree

    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.

  • update_checkoutwrite actionFree

    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.

Public scan report

scanner v0.1.10 · 2026-10-24 · same rubric, same numbers if you re-run it

no findings
  • –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
Overall 79/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.