Server definition

Hash: sha256:f1cb63d0cad33a81ffe8303735056f8f0fac98c65d76e0363835cdc922496d79
What it is: What a remote MCP server returned when asked what it offers: 26 tools

The blob, as servednamed by its sha256

{
  "instructions": null,
  "tools": [
    {
      "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": {
        "properties": {
          "cart_id": {
            "type": "string"
          }
        },
        "required": [
          "cart_id"
        ],
        "type": "object"
      },
      "name": "cancel_cart",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "checkout_id": {
            "type": "string"
          }
        },
        "required": [
          "checkout_id"
        ],
        "type": "object"
      },
      "name": "cancel_checkout",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "colour_name": {
            "type": "string"
          },
          "product_id": {
            "type": "string"
          }
        },
        "required": [
          "product_id",
          "colour_name"
        ],
        "type": "object"
      },
      "name": "check_colour_stock",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "checkout_id": {
            "type": "string"
          },
          "payment_method": {
            "description": "Overrides any value set in create_checkout/update_checkout",
            "enum": [
              "yoco",
              "ozow"
            ],
            "type": "string"
          }
        },
        "required": [
          "checkout_id"
        ],
        "type": "object"
      },
      "name": "complete_checkout",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "colour": {
            "description": "Colour name (must match available colours)",
            "type": "string"
          },
          "finish": {
            "description": "Optional finish for aluminium venetians",
            "type": "string"
          },
          "height_mm": {
            "description": "Height/drop in millimetres",
            "type": "number"
          },
          "mount_type": {
            "description": "Mount type: inside (recess) or outside (face-fix)",
            "enum": [
              "inside",
              "outside"
            ],
            "type": "string"
          },
          "product_id": {
            "description": "Product ID from search_products",
            "type": "string"
          },
          "province": {
            "description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.",
            "type": "string"
          },
          "quantity": {
            "description": "Number of blinds (default 1)",
            "type": "number"
          },
          "width_mm": {
            "description": "Width in millimetres",
            "type": "number"
          }
        },
        "required": [
          "product_id",
          "width_mm",
          "height_mm",
          "colour",
          "mount_type"
        ],
        "type": "object"
      },
      "name": "configure_product",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer": {
            "description": "Optional customer details",
            "type": "object"
          },
          "items": {
            "description": "Optional initial items (configured blinds)",
            "type": "array"
          }
        },
        "type": "object"
      },
      "name": "create_cart",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "cart_id": {
            "description": "Either cart_id or items required",
            "type": "string"
          },
          "customer": {
            "properties": {
              "address": {
                "type": "string"
              },
              "city": {
                "type": "string"
              },
              "email": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "phone": {
                "type": "string"
              }
            },
            "required": [
              "name",
              "email",
              "phone"
            ],
            "type": "object"
          },
          "items": {
            "type": "array"
          },
          "payment_method": {
            "description": "Default 'yoco'",
            "enum": [
              "yoco",
              "ozow"
            ],
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "create_checkout",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer_address": {
            "description": "Delivery address",
            "type": "string"
          },
          "customer_city": {
            "description": "Delivery city",
            "type": "string"
          },
          "customer_email": {
            "description": "Customer email address",
            "type": "string"
          },
          "customer_name": {
            "description": "Customer full name",
            "type": "string"
          },
          "customer_phone": {
            "description": "Customer phone number",
            "type": "string"
          },
          "items": {
            "description": "Array of configured blind items",
            "items": {
              "properties": {
                "colour": {
                  "type": "string"
                },
                "finish": {
                  "type": "string"
                },
                "height_mm": {
                  "type": "number"
                },
                "mount_type": {
                  "type": "string"
                },
                "product_id": {
                  "type": "string"
                },
                "product_name": {
                  "type": "string"
                },
                "quantity": {
                  "type": "number"
                },
                "total_price_zar": {
                  "type": "number"
                },
                "unit_price_zar": {
                  "type": "number"
                },
                "width_mm": {
                  "type": "number"
                }
              },
              "required": [
                "product_id",
                "width_mm",
                "height_mm",
                "colour",
                "mount_type",
                "unit_price_zar",
                "total_price_zar"
              ],
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "items",
          "customer_name",
          "customer_email",
          "customer_phone"
        ],
        "type": "object"
      },
      "name": "create_order",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "mode": {
            "description": "Which tool to surface. Default: both.",
            "enum": [
              "measure",
              "visualize",
              "both"
            ],
            "type": "string"
          },
          "product_id": {
            "description": "Optional. Pre-select a product in the visualizer (e.g. roller-blockout, venetian-25mm-aluwood).",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_ar_visualizer_url",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "cart_id": {
            "type": "string"
          }
        },
        "required": [
          "cart_id"
        ],
        "type": "object"
      },
      "name": "get_cart",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "checkout_id": {
            "type": "string"
          }
        },
        "required": [
          "checkout_id"
        ],
        "type": "object"
      },
      "name": "get_checkout",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "order_date": {
            "description": "ISO date string of the order placement date (e.g. '2026-05-18'). Defaults to today.",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_delivery_estimate",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer_email": {
            "type": "string"
          },
          "order_id": {
            "type": "string"
          }
        },
        "required": [
          "order_id",
          "customer_email"
        ],
        "type": "object"
      },
      "name": "get_order",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "order_total_zar": {
            "description": "Optional. For future per-handler limit filtering.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "get_payment_methods",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "finish": {
            "description": "Optional finish for aluminium products: Plain, Brushed, Woodgrain",
            "type": "string"
          },
          "height_mm": {
            "description": "Height/drop in millimetres (e.g. 1500)",
            "type": "number"
          },
          "product_id": {
            "description": "Product ID from search_products (e.g. roller-blockout, venetian-25mm-aluminium)",
            "type": "string"
          },
          "province": {
            "description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.",
            "type": "string"
          },
          "quantity": {
            "description": "Number of blinds (default 1)",
            "type": "number"
          },
          "width_mm": {
            "description": "Width in millimetres (e.g. 1200)",
            "type": "number"
          }
        },
        "required": [
          "product_id",
          "width_mm",
          "height_mm"
        ],
        "type": "object"
      },
      "name": "get_price",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "product_id": {
            "type": "string"
          }
        },
        "required": [
          "product_id"
        ],
        "type": "object"
      },
      "name": "get_product",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "aesthetic": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "max_budget_zar": {
            "type": "number"
          },
          "primary_concern": {
            "enum": [
              "blockout",
              "heat",
              "glare",
              "moisture",
              "privacy",
              "security",
              "automation"
            ],
            "type": "string"
          },
          "room": {
            "type": "string"
          }
        },
        "required": [
          "primary_concern"
        ],
        "type": "object"
      },
      "name": "get_product_recommendation",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer_name": {
            "type": "string"
          },
          "location": {
            "description": "City/suburb. Drives Duncan vs shop routing.",
            "type": "string"
          },
          "message": {
            "description": "Optional additional message to prefill",
            "type": "string"
          },
          "product_context": {
            "description": "e.g. 'roller blockout for bedroom'",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "get_whatsapp_handoff",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "category": {
            "description": "roller | venetian | honeycomb | vertical | outdoor",
            "type": "string"
          },
          "colour": {
            "type": "string"
          },
          "max_height_mm": {
            "type": "number"
          },
          "max_width_mm": {
            "type": "number"
          }
        },
        "type": "object"
      },
      "name": "lookup_catalog",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "competitor_name": {
            "description": "Name of the competitor (e.g. 'Blind Empire')",
            "type": "string"
          },
          "competitor_price_zar": {
            "description": "Competitor's price in ZAR (incl. VAT)",
            "type": "number"
          },
          "competitor_url": {
            "description": "URL to competitor product page or quote",
            "type": "string"
          },
          "customer_name": {
            "description": "Customer name",
            "type": "string"
          },
          "customer_whatsapp": {
            "description": "Customer WhatsApp number for follow-up",
            "type": "string"
          },
          "height_mm": {
            "description": "Window height/drop in mm",
            "type": "number"
          },
          "product_id": {
            "description": "Product the customer wants to match (e.g. roller-blockout)",
            "type": "string"
          },
          "width_mm": {
            "description": "Window width in mm",
            "type": "number"
          }
        },
        "required": [
          "product_id",
          "competitor_price_zar"
        ],
        "type": "object"
      },
      "name": "request_price_match",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer_email": {
            "type": "string"
          },
          "customer_name": {
            "type": "string"
          },
          "customer_phone": {
            "description": "Used as WhatsApp number",
            "type": "string"
          },
          "product_interest": {
            "description": "e.g. 'Roller Blockout' or 'Honeycomb'",
            "type": "string"
          },
          "suburb": {
            "description": "Optional delivery suburb",
            "type": "string"
          },
          "swatch_codes": {
            "description": "Optional specific colour codes (max 5)",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "customer_name",
          "customer_email",
          "customer_phone",
          "product_interest"
        ],
        "type": "object"
      },
      "name": "request_swatch",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "query": {
            "description": "Free-text query, e.g. 'blockout' or 'venetian'",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_catalog",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "colour": {
            "description": "Colour name to search for (partial match)",
            "type": "string"
          },
          "max_height_mm": {
            "description": "Maximum height/drop in millimetres the product supports",
            "type": "number"
          },
          "max_width_mm": {
            "description": "Maximum width in millimetres the product supports",
            "type": "number"
          },
          "province": {
            "description": "Optional. Customer's South African province or city. Garden Route locations get Duncan's direct contact; other locations get the online shop contact.",
            "type": "string"
          },
          "type": {
            "description": "Blind category to filter by: roller, venetian, honeycomb, vertical, outdoor",
            "type": "string"
          }
        },
        "type": "object"
      },
      "name": "search_products",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "customer_email": {
            "description": "Customer email address",
            "type": "string"
          },
          "customer_name": {
            "description": "Customer full name",
            "type": "string"
          },
          "customer_phone": {
            "description": "Customer phone number",
            "type": "string"
          },
          "message": {
            "description": "Additional message or questions from the customer",
            "type": "string"
          },
          "product_config": {
            "description": "Product configuration from configure_product",
            "properties": {
              "colour": {
                "type": "string"
              },
              "height_mm": {
                "type": "number"
              },
              "mount_type": {
                "type": "string"
              },
              "price_zar": {
                "type": "number"
              },
              "product_id": {
                "type": "string"
              },
              "product_name": {
                "type": "string"
              },
              "width_mm": {
                "type": "number"
              }
            },
            "type": "object"
          }
        },
        "required": [
          "product_config",
          "customer_name",
          "customer_email",
          "customer_phone"
        ],
        "type": "object"
      },
      "name": "submit_enquiry",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "cart_id": {
            "type": "string"
          },
          "customer": {
            "type": "object"
          },
          "indices": {
            "description": "Item indices to remove (0-based) when op='remove'",
            "items": {
              "type": "number"
            },
            "type": "array"
          },
          "items": {
            "type": "array"
          },
          "op": {
            "enum": [
              "add",
              "remove",
              "set",
              "clear"
            ],
            "type": "string"
          }
        },
        "required": [
          "cart_id"
        ],
        "type": "object"
      },
      "name": "update_cart",
      "outputSchema": null
    },
    {
      "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": {
        "properties": {
          "checkout_id": {
            "type": "string"
          },
          "customer": {
            "type": "object"
          },
          "payment_method": {
            "enum": [
              "yoco",
              "ozow"
            ],
            "type": "string"
          }
        },
        "required": [
          "checkout_id"
        ],
        "type": "object"
      },
      "name": "update_checkout",
      "outputSchema": null
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:f1cb63d0cad33a81ffe8303735056f8f0fac98c65d76e0363835cdc922496d79 | sha256sum