{"data":{"name":"io.github.CustomBlinds/cb-shop","title":"Custom Blinds Shop","description":"South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.","version":"1.0.0","websiteUrl":null,"repositoryUrl":"https://github.com/CustomBlinds/cb-shop-mcp","remotes":[{"url":"https://shop.customblinds.co.za/mcp","type":"streamable-http","headers":[{"name":"Authorization","isSecret":true,"description":"Bearer token — only for submit_enquiry and create_order. Catalogue and pricing tools are open."}]}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-05-28T08:19:05.012Z","updatedAt":"2026-05-28T08:19:05.012Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"stars":null,"title":"Custom Blinds Shop","source":"official-registry","sourceId":"io.github.CustomBlinds/cb-shop","updatedAt":"2026-05-28T08:19:05.012Z","confidence":100,"websiteUrl":null,"description":"South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.","verification":"official","repositoryUrl":"https://github.com/CustomBlinds/cb-shop-mcp"}],"toolIndex":{"tools":[{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"cancel_cart","title":"Cancel a 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.","inputSchema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]},"annotations":{"title":"Cancel a cart","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false},"definitionHash":"a05700c4c4365c9ddf9febad4a066412ee7e7ee77fd9470729290554334e6c9f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"cancel_checkout","title":"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.","inputSchema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]},"annotations":{"title":"Cancel checkout","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false},"definitionHash":"396f99816bb077ea41a27156c6022b76933eaa197708ee1ab89d2a01a43b3897","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"check_colour_stock","title":"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. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).","inputSchema":{"type":"object","properties":{"product_id":{"type":"string"},"colour_name":{"type":"string"}},"required":["product_id","colour_name"]},"annotations":{"title":"Check colour stock","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"674db5a4024758e2de2b46205aca0e890ae374331993d0fe158c6d32bd1be7b5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"complete_checkout","title":"Get the payment link","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. 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.","inputSchema":{"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"]},"annotations":{"title":"Get the payment link","readOnlyHint":false,"destructiveHint":true,"openWorldHint":true},"definitionHash":"d3aa544cc6e1273102ec3edc31e6a1fb7be4f4d82c55d85099b2f228cd3a7334","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"configure_product","title":"Configure a blind","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. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).","inputSchema":{"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."},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."}},"required":["product_id","width_mm","height_mm","colour","mount_type"]},"annotations":{"title":"Configure a blind","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"d1fda7686d4206e0b8ad6d1646787d1db8c4357247574a3400cbc961fbf13a4b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"create_cart","title":"Create a 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. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).","inputSchema":{"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 inside mount 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"},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."}},"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"}}}}},"annotations":{"title":"Create a cart","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false},"definitionHash":"51dd047fdb65cf9460e5700292aa00f63a3b48a18afc24f1fd8b141d566ec1a2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"create_checkout","title":"Start checkout","description":"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.","inputSchema":{"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 inside mount 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"},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."}},"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"]}}}]},"annotations":{"title":"Start checkout","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false},"definitionHash":"91c5b10cb063fbc108dc7227ed434ebdb9421d131e6b638da7810ecc6c298f84","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"create_quote_link","title":"Create a shareable quote","description":"Make a shareable quote page for the customer, with no side effects: no order, no email, no payment link and no stock hold. Each blind is priced and stock-checked now; the page shows the lines and total and its button fills the customer's cart and opens checkout, where prices are checked again. Valid 7 days. Use this when the customer wants to review, share or pay later, instead of create_checkout.","inputSchema":{"type":"object","properties":{"items":{"type":"array","minItems":1,"maxItems":20,"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 inside mount 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"},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."},"control_side":{"type":"string","enum":["left","right"],"description":"Chain or control side, as the customer faces the window. Defaults to right."}},"required":["product_id","width_mm","height_mm","colour","mount_type"]},"description":"Configured blinds; validate colours with configure_product first"}},"required":["items"]},"annotations":{"title":"Create a shareable quote","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false},"definitionHash":"a6a4681e1696bd628db017acab6f04a5e4052967024edb55cf686f2ec9145f1e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_ar_visualizer_url","title":"Get the web visualiser link","description":"Returns the link to the Custom Blinds Visualiser (See it before you buy it), pre-selected to the product when it is supported. The customer adds a photo of their window (any angle), picks a blind and colour, and previews it on their own window. A preview of colour and style, not a measuring tool. No measuring or marking. A name and WhatsApp number are needed; 2 free previews per customer. Also returns the measuring guide (mode 'measure' makes it the main url) and the list of supported products. A customer still unsure of sizes can order with best guess sizes, receive a free tape measure and confirm before production starts. Use when a customer wants to see how a blind or colour will look before ordering, or is unsure how to measure. If you already have the customer's photo, use start_visualiser_preview to show the blind in this chat instead.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Optional. Pre-select a product in the visualiser (e.g. roller-blockout, double-roller-zebra, outdoor-blinds)."},"mode":{"type":"string","enum":["measure","visualize","both"],"description":"Which link goes in url: visualize (own-window visualiser), measure (measuring guide) or both (visualiser, the default). Both links are always returned."}}},"annotations":{"title":"Get the web visualiser link","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"86b494c67f8cdf014a6d063798bfa52985d60e5bef8d4e5cf73b51ebfdc82fcb","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_cart","title":"View a 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.","inputSchema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]},"annotations":{"title":"View a cart","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"1ced3d02e26c353133e094942783787973ce989d4e40acf249f818de263b1d3e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_checkout","title":"View 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.","inputSchema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]},"annotations":{"title":"View checkout","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"3d01b526a6778de0f07928be7a2ec78f340068f8861ca0172dd18af0b4be3a63","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_delivery_estimate","title":"Estimate lead time and delivery","description":"Lead time for a new order. Production takes 5 to 7 working days once payment clears, outside peak seasons. Pass the customer's town and 4-digit street postal_code (province and suburb help) and the transit range is The Courier Guy's own quote from our Knysna depot to that town; without them it is the standard 2 to 5 working days. Returns working-day ranges and a summary safe to share. Never quote a dispatch or delivery date: weather and production set them.","inputSchema":{"type":"object","properties":{"town":{"type":"string","description":"Customer's town or city, e.g. 'Johannesburg'"},"postal_code":{"type":"string","description":"4-digit South African STREET postal code, e.g. 2196"},"suburb":{"type":"string","description":"Optional suburb, e.g. Sandton"},"province":{"type":"string","description":"Optional province, e.g. Gauteng"},"width_mm":{"type":"number","description":"Optional widest blind in mm (sets the parcel length)"},"order_date":{"type":"string","description":"ISO date of the order (e.g. '2026-05-18'). Defaults to today."}}},"annotations":{"title":"Estimate lead time and delivery","readOnlyHint":true,"destructiveHint":false,"openWorldHint":true},"definitionHash":"bd785bc0bbf02061ebf8bd94a22f48fad73205118556328667976a74c1d041f8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_order","title":"Check an 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.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string"},"customer_email":{"type":"string"}},"required":["order_id","customer_email"]},"annotations":{"title":"Check an order","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"56d8626b14fb176694af3fd0408ead8eb312200f78a9fcb3eb7f266f90c1fad5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_payment_methods","title":"List 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.","inputSchema":{"type":"object","properties":{"order_total_zar":{"type":"number","description":"Optional. For future per-handler limit filtering."}}},"annotations":{"title":"List payment methods","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"021592ce1161d362808df04bd4914d5d914d95305d43e62cce945b53e3fcd0db","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_price","title":"Get price for a size","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.","inputSchema":{"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."},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."}},"required":["product_id","width_mm","height_mm"]},"annotations":{"title":"Get price for a size","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"b8ac3bbb9dabe69a2d5d172112a8f89e8c466eedd97dad9f95201cb998cd3c72","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_product","title":"Get product details","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. Duo Roller: colour is one blockout and one sheer written \"Blockout + Sheer\" (get_product returns duo_fabrics).","inputSchema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]},"annotations":{"title":"Get product details","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"0c766c82b6d7b2e59377f45ec70c2d2bfe41f937e1ef3d81ae41476a689df5f1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_product_recommendation","title":"Recommend a blind","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. For security there is no shop product: it returns a hand-off to our security shutters page (installed in the Garden Route only).","inputSchema":{"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"]},"annotations":{"title":"Recommend a blind","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"8be6980d744f8c54247126e3e791d7629870746c8c9a23fd1dc737f9f6755c8a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_visualiser_preview","title":"Get the window preview","description":"Draw and return the preview for a job_id from start_visualiser_preview: the blind in the chosen colour on the customer's photo, as an image in the result and as image_url (kept 7 days). The first call draws it (30 to 90 s; outdoor up to 2 minutes); status \"drawing\" means call again after retry_after_seconds.","inputSchema":{"type":"object","properties":{"job_id":{"type":"string"}},"required":["job_id"]},"annotations":{"title":"Get the window preview","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"7b17ab07a0c54bde3a0e0abe09cef2f17701457b839a6cbe0074c82aaed2f344","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"get_whatsapp_handoff","title":"Hand over to WhatsApp","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 on WhatsApp (+27795235407) for a free in-home consultation. Awnings, shutters, shadeports and Ziptrak, named in product_context, route to Duncan Kane from anywhere in South Africa. Everything else routes to the shop WhatsApp (+27760228410), WhatsApp only, no voice calls. Use when the customer prefers human assistance or when self-serve checkout isn't appropriate.","inputSchema":{"type":"object","properties":{"customer_name":{"type":"string"},"product_context":{"type":"string","description":"e.g. 'roller blockout for bedroom'. Awnings, shutters, shadeports or Ziptrak here route to Duncan."},"message":{"type":"string","description":"Optional additional message to prefill"},"location":{"type":"string","description":"City/suburb. Garden Route locations route to Duncan."}}},"annotations":{"title":"Hand over to WhatsApp","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"ad5c235716d2c34d0802bfb606ffc7688c4465f2e5762bda83b3e5a4ac562333","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"lookup_catalog","title":"Filter the catalogue","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.","inputSchema":{"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"}}},"annotations":{"title":"Filter the catalogue","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"8fe4a8fd9d2b82bb5f8c7dbd17d0c90f0515fba271b32a3877c19247c46b0cbf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"request_price_match","title":"Prepare a price-match request","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, international retailers, or items out of stock at the other retailer. Requires product_id and competitor_price_zar at minimum.","inputSchema":{"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 other retailer"},"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"]},"annotations":{"title":"Prepare a price-match request","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"401e7a966bd1339d5b69e870697314dd81eb1a932710571381083c3a3cc2deac","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"request_swatch","title":"Request fabric swatches","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). Sample swatches, not off-cuts: on orders over R8,000 the customer can ask on WhatsApp for swatches in the colours they like, for the product they are ordering; if nothing suits, full refund with no fees. Never quote a sample price or courier cost.","inputSchema":{"type":"object","properties":{"customer_name":{"type":"string","description":"Customer's full name."},"customer_email":{"type":"string","description":"Customer's email address."},"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"]},"annotations":{"title":"Request fabric swatches","readOnlyHint":false,"destructiveHint":false,"openWorldHint":false},"definitionHash":"85521a2d63e9d4589374d40affeea949341f57709ecb7f6d32ea97b76f34e61e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"search_catalog","title":"Search the blinds catalogue","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.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Free-text query, e.g. 'blockout' or 'venetian'"}}},"annotations":{"title":"Search the blinds catalogue","readOnlyHint":true,"destructiveHint":false,"openWorldHint":false},"definitionHash":"676cef5827ce69db50519fdfb037e954c5faff7274341bbba46807c54a2c5acf","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"start_visualiser_preview","title":"Start a window or patio preview","description":"Show the customer a blind on THEIR OWN window or patio, in this chat. Pass the photo they gave you (image_url https, or image_base64; for outdoor blinds, the patio opening taken straight on), the product_id and an exact in-stock colour name (get_product), and the customer's name and South African WhatsApp number (required: the team follows up on WhatsApp, and each number gets 2 free previews). Indoor blinds, and the outdoor screen, clear PVC and canvas blinds (not outdoor bamboo). Finds the windows or patio openings (20 to 45 s) and returns job_id; then call get_visualiser_preview. A preview of colour and style, not a measuring tool.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Visualiser blind, e.g. roller-blockout, duo-roller, venetian-25mm-aluminium, honeycomb-blockout, outdoor-blinds, outdoor-blinds-pvc, outdoor-blinds-canvas"},"colour":{"type":"string","description":"Exact in-stock colour name from get_product (for a Duo Roller, one of its listed colours)"},"customer_name":{"type":"string"},"whatsapp":{"type":"string","description":"Customer's South African WhatsApp number"},"image_url":{"type":"string","description":"https URL of the customer's window or patio photo (JPEG, PNG or WebP, under 6 MB)"},"image_base64":{"type":"string","description":"Or the photo itself, base64"}},"required":["product_id","colour","customer_name","whatsapp"]},"annotations":{"title":"Start a window or patio preview","readOnlyHint":false,"destructiveHint":false,"openWorldHint":true},"definitionHash":"f51e12535761396661c4a4b3aba9277005370b46959d8ea5082a074a2f5a2c3b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"},{"serverName":"io.github.CustomBlinds/cb-shop","endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","name":"update_cart","title":"Update a 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.","inputSchema":{"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 inside mount 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"},"no_drill":{"type":"boolean","description":"Optional. true for the no-drill option (tension brackets, inside the frame, max 2000mm wide; 1500mm on 25mm venetians). Adds the R65 no-drill kit per blind. Offered on indoor roller blinds, including value rollers, and 25mm aluminium or aluwood venetians. Dedicated no-drill products already include the kit."}},"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"]},"annotations":{"title":"Update a cart","readOnlyHint":false,"destructiveHint":true,"openWorldHint":false},"definitionHash":"3071142843133b653b2d6fcf986a17ee3384f118865a9204e16012eddc681ae4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-19T02:46:33.789Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"9606438dc1a98d64c71ee468fd10340a737de78586a8213ed26d19eb79954c08","protocol":"streamable-http","status":"indexed","toolCount":27,"observedAt":"2026-11-19T02:46:33.789Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"io.github.CustomBlinds/cb-shop":{"url":"https://shop.customblinds.co.za/mcp"}}},"Cursor":{"mcpServers":{"io.github.CustomBlinds/cb-shop":{"url":"https://shop.customblinds.co.za/mcp"}}},"VS Code":{"servers":{"io.github.CustomBlinds/cb-shop":{"type":"http","url":"https://shop.customblinds.co.za/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://shop.customblinds.co.za/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:io.github.CustomBlinds%2Fcb-shop","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/io.github.CustomBlinds%2Fcb-shop","name":"io.github.CustomBlinds/cb-shop","description":"South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://shop.customblinds.co.za/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":null,"repositoryUrl":"https://github.com/CustomBlinds/cb-shop-mcp","version":"1.0.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"io.github.CustomBlinds/cb-shop","status":"online","lastCheckedAt":"2026-11-20T04:16:58.200Z","lastSuccessfulCheck":"2026-11-20T04:16:58.200Z","latencyMs":245,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T04:16:58.200Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T04:16:58.200Z"},"security":null,"timestamps":{"createdAt":"2026-05-28T08:19:05.012Z","updatedAt":"2026-05-28T08:19:05.012Z","observedAt":"2026-11-20T04:16:58.200Z"},"compatibility":{"serverVersion":"1.0.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}