{"schema_version":"2024-11-05","name":"custom-blinds-shop","display_name":"Custom Blinds Shop","description":"Browse products, get instant pricing, configure blinds, submit enquiries and create orders for custom-made blinds in South Africa.","configSchema":{},"systemPrompt":"You are operating as the Custom Blinds Shop MCP (MCP-2), the transactional node of the CBSA dual-node commerce system. Your role is to handle product search, pricing, cart, checkout and payment for custom-made blinds in South Africa. Use search_catalog or get_product to find products, get_price for ZAR pricing (VAT included), then create_cart → create_checkout → complete_checkout for the full purchase flow. For advisory questions about which blind to choose, route to the Brochure MCP first (customblinds.co.za/mcp). PRODUCT TAXONOMY: Duo Roller = two independent fabric rolls, true blockout achievable. Zebra Blinds (Double Roller) = single fabric with alternating stripes, cannot achieve full blockout — never conflate these. All prices ZAR VAT included. Production: 5 working days. Never quote delivery time. Garden Route customers (Knysna, Plett, George etc): offer Duncan Kane free consultation on 079 523 5407. All others: WhatsApp +27 76 022 8410.","categories":["window-coverings","home-decor","ecommerce","south-africa"],"keywords":["blinds","roller blinds","window treatments","made to measure","South Africa","shutters","awnings"],"url":"https://shop.customblinds.co.za/mcp","manifest_url":"https://shop.customblinds.co.za/mcp-manifest.json","discovery_endpoint":"https://customblinds.co.za/mcp","discovery_manifest":"https://customblinds.co.za/mcp-manifest.json","discovery_note":"Full product discovery, brand context, room advice, and fabric expertise live at the brochure MCP (customblinds.co.za/mcp). A cold AI should start there for product education, then use this shop MCP for live pricing and order placement. The UCP checkout flow (create_checkout → complete_checkout) requires no authentication — a handoff from the brochure MCP can go all the way to a Yoco payment link without credentials.","cbsa_node":"MCP-2","cbsa_role":"transactional","cbsa_system_prompt_url":"https://shop.customblinds.co.za/gpt-system-prompt.txt","routing_rules":{"this_node":"SHOP MCP — handles cart, pricing, checkout, payment, order tracking. Forbidden: vague advice without product mapping.","peer_node":"BROCHURE MCP (https://customblinds.co.za/mcp) — handles education, design, lead capture, consultation. Forbidden: checkout, payment, order confirmation.","route_to_shop":["buy","order","checkout","price now","add to cart","payment"],"route_to_brochure":["measure","advice","compare","design","options","what should I choose","inspiration"],"mixed_intent":"BROCHURE MCP first → escalate to SHOP MCP with full context transfer","uncertain_intent":"Default to BROCHURE MCP. Never guess a transaction.","context_transfer_object":{"required":["product_type","width_mm","height_mm"],"recommended":["room","budget_zar","preference","colour"],"note":"Pass all available fields to get_product_recommendation or configure_product on arrival at Shop MCP. Customer should never repeat themselves."},"call_sequence":["1. get_product_recommendation — concern + room → product slug","2. search_catalog / get_product — confirm slug, colours, max dimensions","3. get_price — exact ZAR (width_mm, height_mm, VAT included)","4. configure_product — colour + mount_type","5. create_cart → create_checkout → complete_checkout → Yoco / Ozow payment link"]},"capabilities":{"tools":true},"authentication":{"type":"bearer","description":"Bearer token required only for legacy tools (submit_enquiry, create_order). The full UCP flow — search_catalog, lookup_catalog, get_product, get_product_recommendation, get_price, configure_product, check_colour_stock, get_payment_methods, get_whatsapp_handoff, create_cart, get_cart, update_cart, cancel_cart, create_checkout, get_checkout, update_checkout, complete_checkout, cancel_checkout, get_order — is completely open. No credentials needed to browse, price, or take a customer from catalogue to Yoco payment link. Note: request_swatch is fulfilled at order placement only, not as a standalone dispatch."},"contact":{"email":"sales@customblinds.co.za","whatsapp":"+27760228410"},"tools":[{"name":"search_products","description":"Use when the customer hasn't specified a product ID yet. Filters by blind type (roller, venetian, honeycomb, vertical, outdoor), colour name, or maximum window dimensions in mm. Returns product_id, name, description, features, and in-stock colour count. Pass the product_id to get_price or configure_product as the next step.","inputSchema":{"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."}}},"requires_auth":false},{"name":"get_price","description":"Get an exact ZAR price for a product at specific dimensions. Requires product_id (from search_products or lookup_catalog), width_mm, and height_mm. Returns unit_price_zar and total_price_zar (VAT included). Call configure_product next to lock in colour and mount type before creating a cart.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Product ID from search_products (e.g. roller-blockout, venetian-25mm-aluminium)"},"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"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Product ID from search_products"},"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","enum":["inside","outside"],"description":"Mount type: inside (recess) or outside (face-fix)"},"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"]},"requires_auth":false},{"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.","inputSchema":{"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","description":"Additional message or questions from the customer"}},"required":["product_config","customer_name","customer_email","customer_phone"]},"requires_auth":true},{"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.","inputSchema":{"type":"object","properties":{"items":{"type":"array","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","unit_price_zar","total_price_zar"]}},"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"}},"required":["items","customer_name","customer_email","customer_phone"]},"requires_auth":true},{"name":"search_catalog","description":"Free-text search across the full catalogue — use for open queries like 'blockout for bedroom' or 'wood venetian'. Returns id, name, category, description, and product_url. For filtering by category, colour, or dimensions use lookup_catalog instead. Pass the returned id to get_product or get_price.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Free-text query, e.g. 'blockout' or 'venetian'"}}},"requires_auth":false},{"name":"lookup_catalog","description":"Structured catalogue filter: narrow by category (roller | venetian | honeycomb | vertical | outdoor), colour name, max_width_mm, or max_height_mm. Ideal when the customer has stated a blind type. Returns matching products with id and product_url. Use search_catalog for open-ended natural language queries.","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"}}},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string"}},"required":["product_id"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"items":{"type":"array","description":"Optional initial items (configured blinds)"},"customer":{"type":"object","description":"Optional customer details"}}},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"cart_id":{"type":"string"},"op":{"type":"string","enum":["add","remove","set","clear"]},"items":{"type":"array"},"indices":{"type":"array","items":{"type":"number"},"description":"Item indices to remove (0-based) when op='remove'"},"customer":{"type":"object"}},"required":["cart_id"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"cart_id":{"type":"string"}},"required":["cart_id"]},"requires_auth":false},{"name":"create_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"},"customer":{"type":"object","properties":{"name":{"type":"string"},"email":{"type":"string"},"phone":{"type":"string"},"address":{"type":"string"},"city":{"type":"string"}},"required":["name","email","phone"]},"payment_method":{"type":"string","enum":["yoco","ozow"],"description":"Default 'yoco'"}}},"requires_auth":false},{"name":"get_checkout","description":"Poll a checkout by checkout_id. Returns status (pending | paid | cancelled), full item list, customer details, and payment_url if already minted. Use to verify customer details before calling complete_checkout, or to retrieve the payment_url if complete_checkout was already called.","inputSchema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]},"requires_auth":false},{"name":"update_checkout","description":"Correct customer details (name, email, phone, address) or switch payment_method (yoco | ozow) on an unpaid checkout before calling complete_checkout. Returns the updated checkout state. Raises an error if the checkout is already paid or cancelled.","inputSchema":{"type":"object","properties":{"checkout_id":{"type":"string"},"customer":{"type":"object"},"payment_method":{"type":"string","enum":["yoco","ozow"]}},"required":["checkout_id"]},"requires_auth":false},{"name":"complete_checkout","description":"Phase 2 of 2. Finalise a checkout and mint the payment link — Yoco for card payments or Ozow for instant EFT. Returns payment_url to share with the customer. Payment confirmation arrives via webhook; poll get_order afterwards to confirm paid status. Once called, the checkout is locked — use cancel_checkout to abort if the customer changes their mind before paying.","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"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"checkout_id":{"type":"string"}},"required":["checkout_id"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string"},"customer_email":{"type":"string"}},"required":["order_id","customer_email"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string"},"colour_name":{"type":"string"}},"required":["product_id","colour_name"]},"requires_auth":false},{"name":"request_swatch","description":"Register up to 5 colour swatches to be dispatched with the customer's order. Swatches ship at order placement only — they are NOT sent as a standalone postal sample before purchase. Capped at 5 codes per order. If the customer asks for swatches before ordering, explain they ship with the blind and guide them to place their order first.","inputSchema":{"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)"}},"required":["customer_name","customer_email","customer_phone","product_interest"]},"requires_auth":false},{"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.","inputSchema":{"type":"object","properties":{"order_total_zar":{"type":"number","description":"Optional. For future per-handler limit filtering."}}},"requires_auth":false},{"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 (+27795235407) for free in-home consultation; all other South African locations route to the online shop line (+27760228410). 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'"},"message":{"type":"string","description":"Optional additional message to prefill"},"location":{"type":"string","description":"City/suburb. Drives Duncan vs shop routing."}}},"requires_auth":false},{"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).","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"]},"requires_auth":false},{"name":"get_ar_visualizer_url","description":"Surface the AR measurement tool or product visualizer when a customer wants to measure their window or preview a blind in their room. The AR tool uses a phone camera and an A4 page as a reference scale to measure window dimensions. The visualizer renders the selected blind in a customer-uploaded room photo. Set mode to 'measure', 'visualize', or 'both'. Optionally pre-select a product_id.","inputSchema":{"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."}}},"requires_auth":false},{"name":"get_delivery_estimate","description":"Estimate when a new order will be dispatched. Production is 5 working days (Mon–Fri, excluding South African public holidays). Returns dispatch_date, production_days, and a plain-language summary safe to share with the customer. Never quote a final delivery date — The Courier Guy transit time varies by location. Call this when a customer asks 'when will it arrive?' to give an honest production timeline.","inputSchema":{"type":"object","properties":{"order_date":{"type":"string","description":"ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today."}}},"requires_auth":false},{"name":"request_price_match","description":"Submit a price match claim when the customer has found the same blind cheaper 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: Blinds Direct (same supplier), clearance or flash-sale prices, or out-of-stock items. 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 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"]},"requires_auth":false}]}