MCP server

Custom Blinds Shop Official

io.github.CustomBlinds/cb-shop

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Working at last checkOfficial: customblinds.co.za's GitHub account (CustomBlinds)About 6,930 tokens per request once connected26 tools

Source

https://shop.customblinds.co.za/mcp

At a glance

Type: MCP server
Publisher: customblinds.co.za (verified by the MCP Registry)
Status: Working at last check
Tools: 26
Token cost: About 6,930 tokens per request
Sets up in: Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok
Last checked: 26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to Cursor Add to VS Code VS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

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

Gemini CLI

{"mcpServers":{"cb-shop":{"httpUrl":"https://shop.customblinds.co.za/mcp"}}}

Cursor

{"mcpServers":{"cb-shop":{"url":"https://shop.customblinds.co.za/mcp"}}}

VS Code

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

Antigravity

agy mcp add cb-shop https://shop.customblinds.co.za/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"cb-shop","server_url":"https://shop.customblinds.co.za/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"cb-shop","server_url":"https://shop.customblinds.co.za/mcp"}

Tools

cancel_cart Deletes data · ~104 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.
cancel_checkout Moves money · ~116 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.
check_colour_stock ~154 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 f
complete_checkout Moves money · ~232 tokens
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 successfu
configure_product ~369 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 availabili
create_cart ~567 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.
create_checkout Moves money · ~660 tokens
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 th
create_order Moves money · ~432 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 eng
get_ar_visualizer_url ~201 tokens
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
get_cart ~111 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.
get_checkout ~128 tokens
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_estimate ~170 tokens
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
get_order ~139 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.
get_payment_methods ~144 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_check
get_price ~362 tokens
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 creatin
get_product ~124 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.
get_product_recommendation ~225 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, p
get_whatsapp_handoff ~243 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 for a free in-home consultation, booked on the same WhatsApp line (+27760228410); all other South African locations route to t
lookup_catalog ~166 tokens
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_match ~348 tokens
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-sa
request_swatch ~312 tokens
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
search_catalog ~123 tokens
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_products ~291 tokens
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_pr
submit_enquiry ~344 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
update_cart ~629 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 alread
update_checkout Moves money · ~236 tokens
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.

Browse

Related MCP servers

SiteCheck Shop & Social
113 pay-per-call agent tools: e-commerce, product, price and social media data tools. x402
SiteCheck Jobs & Property
114 pay-per-call agent tools: job market and real estate data tools. x402
Calcgrid
China working-day data, UK bank holidays, IANA time zones and deterministic business deadlines.
South Africa Tenders
South Africa Government Procurement MCP — National Treasury eTenders / OCPO (keyless).
Mapmelon
Search curated community colivings and see who else will be staying during your dates.
Juicy Designs Quote
Free digital marketing quote and strategy requests from Juicy Designs SA. No price returned.
Nomad Stays
Search remote-work accommodations worldwide; Trusted Stay Partners can manage their own listings.
Sarb Za
South African Reserve Bank (SARB) Web API MCP. Keyless.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.CustomBlinds/cb-shop.svg)](https://aptlynx.net/servers/io.github.CustomBlinds/cb-shop)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents