{"name":"io.github.CustomBlinds/cb-shop","slug":"customblinds-cb-shop","title":"Custom Blinds Shop","description":"South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.","url":"https://mcp.market/server/customblinds-cb-shop","rating":null,"grade":"B","score":79,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":11,"stars":0,"forks":0,"downloads_week":null,"last_push_at":"2026-06-22T06:55:16.000Z","license":null},"uptime":{"percent":100,"checks":28,"ok":28,"last_checked_at":"2026-11-04T05:35:40.657Z","last_ok_at":"2026-11-04T05:35:40.657Z","latency_ms":195},"claimed":false,"transport":"remote","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/CustomBlinds/cb-shop-mcp","website":null,"version":"1.0.0","remotes":[{"type":"streamable-http","url":"https://shop.customblinds.co.za/mcp","headers":[{"description":"Bearer token — only for submit_enquiry and create_order. Catalogue and pricing tools are open.","isSecret":true,"name":"Authorization"}]}],"packages":[],"tools":[{"name":"cancel_cart","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]}},{"name":"cancel_checkout","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]}},{"name":"check_colour_stock","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string"},"colour_name":{"type":"string"}},"required":["product_id","colour_name"]}},{"name":"complete_checkout","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"},"payment_method":{"type":"string","enum":["yoco","ozow"],"description":"Overrides any value set in create_checkout/update_checkout"}},"required":["checkout_id"]}},{"name":"configure_product","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string","description":"product_id from search_catalog or lookup_catalog"},"width_mm":{"type":"number","description":"Width in millimetres"},"height_mm":{"type":"number","description":"Height/drop in millimetres"},"colour":{"type":"string","description":"Colour name (must match available colours)"},"mount_type":{"type":"string","minLength":1,"description":"Use inside (recess) or outside (face-fix); handler requires a nonempty value"},"finish":{"type":"string","description":"Optional finish for aluminium venetians"},"quantity":{"type":"number","description":"Number of blinds (default 1)"},"province":{"type":"string","description":"Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."}},"required":["product_id","width_mm","height_mm","colour","mount_type"]}},{"name":"create_cart","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"product_id returned by search_catalog or lookup_catalog"},"product_name":{"type":"string","description":"Optional; server resolves the catalogue name"},"width_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered width in millimetres"},"height_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered drop in millimetres"},"colour":{"type":"string","minLength":1,"description":"Exact available colour; validate with configure_product before adding"},"mount_type":{"type":"string","minLength":1,"description":"Use inside for recess fit or outside for face fix"},"finish":{"type":"string","description":"Optional pricing finish for aluminium Venetians"},"quantity":{"type":"number","description":"Number of blinds; defaults to 1"},"unit_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all prices"},"total_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all totals"}},"required":["product_id","width_mm","height_mm","colour","mount_type"]},"description":"Optional configured items; all submitted prices are ignored"},"customer":{"type":"object","properties":{"name":{"type":"string","description":"Real customer name, checked before checkout creation"},"email":{"type":"string","description":"Real customer email, checked before checkout creation"},"phone":{"type":"string","description":"South African phone number, checked before checkout creation"},"address":{"type":"string"},"city":{"type":"string"}}}}}},{"name":"create_checkout","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"cart_id":{"type":"string","description":"Either cart_id or items required"},"items":{"type":"array","minItems":1,"items":{"type":"object","properties":{"product_id":{"type":"string","description":"product_id returned by search_catalog or lookup_catalog"},"product_name":{"type":"string","description":"Optional; server resolves the catalogue name"},"width_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered width in millimetres"},"height_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered drop in millimetres"},"colour":{"type":"string","minLength":1,"description":"Exact available colour; validate with configure_product before adding"},"mount_type":{"type":"string","minLength":1,"description":"Use inside for recess fit or outside for face fix"},"finish":{"type":"string","description":"Optional pricing finish for aluminium Venetians"},"quantity":{"type":"number","description":"Number of blinds; defaults to 1"},"unit_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all prices"},"total_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all totals"}},"required":["product_id","width_mm","height_mm","colour","mount_type"]}},"customer":{"type":"object","properties":{"name":{"type":"string","description":"Real customer name, checked before checkout creation"},"email":{"type":"string","description":"Real customer email, checked before checkout creation"},"phone":{"type":"string","description":"South African phone number, checked before checkout creation"},"address":{"type":"string"},"city":{"type":"string"}}},"payment_method":{"type":"string","enum":["yoco","ozow"],"description":"Default 'yoco'"}},"anyOf":[{"required":["cart_id"]},{"required":["items","customer"],"properties":{"customer":{"required":["name","email","phone"]}}}]}},{"name":"create_order","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"description":"Array of configured blind items","items":{"type":"object","properties":{"product_id":{"type":"string"},"product_name":{"type":"string"},"width_mm":{"type":"number"},"height_mm":{"type":"number"},"colour":{"type":"string"},"mount_type":{"type":"string"},"finish":{"type":"string"},"quantity":{"type":"number"},"unit_price_zar":{"type":"number"},"total_price_zar":{"type":"number"}},"required":["product_id","width_mm","height_mm","colour","mount_type"]}},"customer_name":{"type":"string","description":"Customer full name"},"customer_email":{"type":"string","description":"Customer email address"},"customer_phone":{"type":"string","description":"Customer phone number"},"customer_address":{"type":"string","description":"Delivery address"},"customer_city":{"type":"string","description":"Delivery city"},"payment_method":{"type":"string","enum":["yoco","ozow"],"default":"yoco","description":"Yoco card or Ozow instant EFT"}},"required":["items","customer_name","customer_email","customer_phone"]}},{"name":"get_ar_visualizer_url","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string","description":"Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood)."},"mode":{"type":"string","enum":["measure","visualize","both"],"description":"Which tool to surface. Default: both."}}}},{"name":"get_cart","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]}},{"name":"get_checkout","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]}},{"name":"get_delivery_estimate","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"order_date":{"type":"string","description":"ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today."}}}},{"name":"get_order","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"order_id":{"type":"string"},"customer_email":{"type":"string"}},"required":["order_id","customer_email"]}},{"name":"get_payment_methods","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"order_total_zar":{"type":"number","description":"Optional. For future per-handler limit filtering."}}}},{"name":"get_price","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string","description":"product_id from search_catalog or lookup_catalog (e.g. roller-blockout)"},"colour":{"type":"string","description":"Optional bamboo colour for colour-specific tier pricing"},"width_mm":{"type":"number","description":"Width in millimetres (e.g. 1200)"},"height_mm":{"type":"number","description":"Height/drop in millimetres (e.g. 1500)"},"finish":{"type":"string","description":"Optional finish for aluminium products: Plain, Brushed, Woodgrain"},"quantity":{"type":"number","description":"Number of blinds (default 1)"},"province":{"type":"string","description":"Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."}},"required":["product_id","width_mm","height_mm"]}},{"name":"get_product","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]}},{"name":"get_product_recommendation","description":"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).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"primary_concern":{"type":"string","enum":["blockout","heat","glare","moisture","privacy","security","automation"]},"room":{"type":"string"},"location":{"type":"string"},"max_budget_zar":{"type":"number"},"aesthetic":{"type":"string"}},"required":["primary_concern"]}},{"name":"get_whatsapp_handoff","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"customer_name":{"type":"string"},"product_context":{"type":"string","description":"e.g. 'roller blockout for bedroom'"},"message":{"type":"string","description":"Optional additional message to prefill"},"location":{"type":"string","description":"City/suburb. Drives Duncan vs shop routing."}}}},{"name":"lookup_catalog","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"category":{"type":"string","description":"roller | venetian | honeycomb | vertical | outdoor"},"colour":{"type":"string"},"max_width_mm":{"type":"number"},"max_height_mm":{"type":"number"}}}},{"name":"request_price_match","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"product_id":{"type":"string","description":"Product the customer wants to match (e.g. roller-blockout)"},"width_mm":{"type":"number","description":"Window width in mm"},"height_mm":{"type":"number","description":"Window height/drop in mm"},"competitor_name":{"type":"string","description":"Name of the competitor (e.g. 'Blind Empire')"},"competitor_url":{"type":"string","description":"URL to competitor product page or quote"},"competitor_price_zar":{"type":"number","description":"Competitor's price in ZAR (incl. VAT)"},"customer_name":{"type":"string","description":"Customer name"},"customer_whatsapp":{"type":"string","description":"Customer WhatsApp number for follow-up"}},"required":["product_id","competitor_price_zar"]}},{"name":"request_swatch","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"customer_name":{"type":"string"},"customer_email":{"type":"string"},"customer_phone":{"type":"string","description":"Used as WhatsApp number"},"product_interest":{"type":"string","description":"e.g. 'Roller Blockout' or 'Honeycomb'"},"suburb":{"type":"string","description":"Optional delivery suburb"},"swatch_codes":{"type":"array","items":{"type":"string"},"description":"Optional specific colour codes (max 5)"},"order_ref":{"type":"string","description":"The order reference the swatches ship with. Required."}},"required":["customer_name","customer_email","customer_phone","product_interest","order_ref"]}},{"name":"search_catalog","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"query":{"type":"string","description":"Free-text query, e.g. 'blockout' or 'venetian'"}}}},{"name":"search_products","description":"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.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"type":{"type":"string","description":"Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor"},"colour":{"type":"string","description":"Colour name to search for (partial match)"},"max_width_mm":{"type":"number","description":"Maximum width in millimetres the product supports"},"max_height_mm":{"type":"number","description":"Maximum height/drop in millimetres the product supports"},"province":{"type":"string","description":"Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact."}}}},{"name":"submit_enquiry","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"product_config":{"type":"object","description":"Product configuration from configure_product","properties":{"product_id":{"type":"string"},"product_name":{"type":"string"},"width_mm":{"type":"number"},"height_mm":{"type":"number"},"colour":{"type":"string"},"mount_type":{"type":"string"},"price_zar":{"type":"number"}}},"customer_name":{"type":"string","description":"Customer full name"},"customer_email":{"type":"string","description":"Customer email address"},"customer_phone":{"type":"string","description":"Customer phone number"},"message":{"type":"string","minLength":10,"description":"Required enquiry message; at least 10 characters after trimming"}},"required":["product_config","customer_name","customer_email","customer_phone","message"]}},{"name":"update_cart","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"cart_id":{"type":"string"},"op":{"type":"string","enum":["add","remove","set","clear"],"default":"set"},"items":{"type":"array","items":{"type":"object","properties":{"product_id":{"type":"string","description":"product_id returned by search_catalog or lookup_catalog"},"product_name":{"type":"string","description":"Optional; server resolves the catalogue name"},"width_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered width in millimetres"},"height_mm":{"type":"number","exclusiveMinimum":0,"description":"Actual ordered drop in millimetres"},"colour":{"type":"string","minLength":1,"description":"Exact available colour; validate with configure_product before adding"},"mount_type":{"type":"string","minLength":1,"description":"Use inside for recess fit or outside for face fix"},"finish":{"type":"string","description":"Optional pricing finish for aluminium Venetians"},"quantity":{"type":"number","description":"Number of blinds; defaults to 1"},"unit_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all prices"},"total_price_zar":{"type":"number","description":"Optional, ignored: server recalculates all totals"}},"required":["product_id","width_mm","height_mm","colour","mount_type"]}},"indices":{"type":"array","items":{"type":"number"},"description":"Item indices to remove (0-based) when op='remove'"},"customer":{"type":"object","properties":{"name":{"type":"string","description":"Real customer name, checked before checkout creation"},"email":{"type":"string","description":"Real customer email, checked before checkout creation"},"phone":{"type":"string","description":"South African phone number, checked before checkout creation"},"address":{"type":"string"},"city":{"type":"string"}}}},"required":["cart_id"]}},{"name":"update_checkout","description":"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.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"checkout_id":{"type":"string"},"customer":{"type":"object","properties":{"name":{"type":"string","description":"Real customer name, checked before checkout creation"},"email":{"type":"string","description":"Real customer email, checked before checkout creation"},"phone":{"type":"string","description":"South African phone number, checked before checkout creation"},"address":{"type":"string"},"city":{"type":"string"}}},"payment_method":{"type":"string","enum":["yoco","ozow"]}},"required":["checkout_id"]}}],"scan":{"score":79,"grade":"B","scanned_at":"2026-10-24T04:03:03.643Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-10-24T04:03:03.593Z","components":{"code":{"score":-1,"max":25,"notes":["remote-only server, no package to scan"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 1283ms"]},"poisoning":{"score":15,"max":15,"notes":["26 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":8,"max":15,"notes":["last push 124 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"probes":[{"url":"https://shop.customblinds.co.za/mcp","reachable":true,"authRequired":false,"latencyMs":1283,"serverInfo":{"name":"custom-blinds-shop","version":"2.0.0"}}],"packages":[],"repo":{"found":true,"owner":"CustomBlinds","repo":"cb-shop-mcp","archived":false,"pushedAt":"2026-06-22T06:55:16Z","stars":0,"forks":0,"openIssues":0,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/217166545?v=4","ownerCreatedAt":"2025-06-20T07:18:54Z"},"icon":{"url":"https://shop.customblinds.co.za/favicon.ico","source":"site","width":32,"height":32},"presence":{"stars":0,"forks":0,"downloadsWeek":null,"license":null,"lastPushAt":"2026-06-22T06:55:16.000Z","score":11}}}},"grade_history":[{"kind":"restore","fromGrade":"C","toGrade":"B","reason":"score 79","createdAt":"2026-10-24T04:03:07.461Z"}],"reviews":[]}