{"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 and stronger room darkening, with possible edge light depending on mount and fit. Zebra Blinds (Double Roller) = single fabric with alternating stripes and allows more light through when closed — never conflate these. All prices ZAR VAT included. Production takes 5–7 working days, excluding transit times and outside peak seasons. 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","required":false,"description":"No credentials needed to browse, price, or complete a checkout. Bearer token required only for submit_enquiry and create_order (legacy tools). Named partner keys available — contact sales@customblinds.co.za.","tiers":{"tier1_open":"All browse/read tools — no auth, no rate limit. search_catalog, lookup_catalog, get_product, get_product_recommendation, get_payment_methods, get_whatsapp_handoff, get_ar_visualizer_url, get_delivery_estimate, get_cart, get_checkout, get_order.","tier2_rate_gated":"Pricing tools — open but rate-limited to 25 calls/IP/hour. get_price, check_colour_stock, configure_product. Bulk pricing extraction is monitored.","tier3_validated":"Checkout flow — open but requires real customer details (valid SA phone, real email, real name). create_cart, update_cart, cancel_cart, create_checkout, update_checkout, complete_checkout, cancel_checkout, request_swatch. Orders from cloud/data-centre IPs are held for manual team approval.","tier4_key_required":"submit_enquiry, create_order. Bearer token required. These tools trigger direct email to our team — protected against spam."}},"usage_policy":{"summary":"This API is provided for AI shopping agents serving real end customers. Browsing, pricing, and checkout are open. Systematic bulk extraction of pricing data for competitive intelligence or resale is prohibited and monitored.","rate_limits":{"calls_per_ip_per_hour":120,"pricing_calls_per_ip_per_hour":25,"checkout_completions_per_ip_per_hour":5,"named_clients":"Higher limits available — contact sales@customblinds.co.za for a named partner key."},"checkout_policy":"Orders require a real South African phone number and email address. Orders from cloud-provider IPs (GCP, AWS, Azure, etc.) are held for manual team verification before a payment link is issued — this is a fraud-prevention measure, not a block. Legitimate customer orders from cloud-hosted agents are fulfilled within a few hours.","ip_protection":"Pricing and catalogue data is proprietary. Agents may retrieve pricing for individual customer orders. Mapping the full pricing matrix across all products and dimensions is a violation of this policy.","contact":"sales@customblinds.co.za or WhatsApp +27 76 022 8410 for partner access or questions."},"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":"Explain the production lead time for a new order. Production takes 5–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.","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}]}