protogrid

Search / io.github.CustomBlinds/cb-shop

Custom Blinds Shop

R0· no sign-in

South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing.

v1.0.0 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality63needs work
Trust87of 100
Uptime, 30 days100%
Latency p502726 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "cb-shop": {
      "type": "http",
      "url": "https://shop.customblinds.co.za/mcp",
      "headers": {
        "Authorization": "Bearer ${CB_SHOP_TOKEN}"
      }
    }
  }
}
claude mcp add --transport http cb-shop https://shop.customblinds.co.za/mcp --header "Authorization: Bearer ${CB_SHOP_TOKEN}"
[mcp_servers.cb-shop]
url = "https://shop.customblinds.co.za/mcp"
bearer_token_env_var = "CB_SHOP_TOKEN"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cb-shop": {
      "type": "remote",
      "url": "https://shop.customblinds.co.za/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:CB_SHOP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "cb-shop": {
      "type": "http",
      "url": "https://shop.customblinds.co.za/mcp",
      "headers": {
        "Authorization": "Bearer ${CB_SHOP_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=cb-shop&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vc2hvcC5jdXN0b21ibGluZHMuY28uemEvbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyICR7Q0JfU0hPUF9UT0tFTn0ifX0%3D"
}
{
  "servers": {
    "cb-shop": {
      "type": "http",
      "url": "https://shop.customblinds.co.za/mcp",
      "headers": {
        "Authorization": "Bearer ${CB_SHOP_TOKEN}"
      }
    }
  }
}
{
  "mcpServers": {
    "cb-shop": {
      "httpUrl": "https://shop.customblinds.co.za/mcp",
      "headers": {
        "Authorization": "Bearer ${CB_SHOP_TOKEN}"
      }
    }
  }
}
extensions:
  "cb-shop":
    enabled: true
    name: "cb-shop"
    type: streamable_http
    uri: "https://shop.customblinds.co.za/mcp"
    headers:
      "Authorization": "Bearer ${CB_SHOP_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${CB_SHOP_TOKEN}. The registry never accepts secret values.

Quality 63 / 100needs work

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_whatsapp_handoff (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); request_price_match (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_payment_methods (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 5,745 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability25 · weight 15
  • warn
    stability.changes26 tool changes in 30 days
  • fail
    stability.rug_pull7 tools kept their name but changed most of their description in 30 days; review before trusting them
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

26 tools, about 5,745 tokens to load them all · tool set a3f16f3ccebb · tools last changed 2026-10-11 · checked 2026-10-19 22:46 UTC

Tool changes

  • request_price_matchchangedoutput schema
  • get_delivery_estimatechangedoutput schema
  • get_ar_visualizer_urlchangedoutput schema
  • get_product_recommendationchangedoutput schema
  • get_whatsapp_handoffchangedoutput schema
  • get_payment_methodschangedoutput schema
  • request_swatchchangedinput schema, output schema
  • check_colour_stockchangedoutput schema
  • get_orderchangedoutput schema
  • cancel_checkoutchangedoutput schema

Showing the latest 10. Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 87 / 100

provenance80
liveness100
freshness65
hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% ~updated-145d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://shop.customblinds.co.za/mcp streamable-httpnoneyes100%2726 ms2024-11-052026-10-19

Tools (26)

cancel_cartPermanently 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.
cancel_checkoutAbort 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.
check_colour_stockVerify 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.
complete_checkoutGenerate a Yoco card or Ozow instant-EFT payment link; this does NOT complete payment. Rejects cancelled checkouts and rechecks stock and totals first. An atomic claim prevents competing gateway calls. Returns payment_url or null plus status and message; cloud callers may be held. Retain a successful URL: repeat calls return payment_pending with no URL. Gateway failures raise an error, send no payment-link email and require team review rather than an automatic retry. Poll get_order with customer_email for payment status.
configure_productLock 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.
create_cartStart 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.
create_checkoutPhase 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.
create_orderLegacy 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.
get_ar_visualizer_urlSurface 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.
get_cartRetrieve 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.
get_checkoutRead 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.
get_delivery_estimateExplain 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.
get_orderRetrieve 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.
get_payment_methodsList 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.
get_priceGet 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.
get_productFetch 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.
get_product_recommendationTranslate 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).
get_whatsapp_handoffGenerate 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.
lookup_catalogPreferred 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.
request_price_matchSubmit 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.
request_swatchRegister 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.
search_catalogPreferred 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.
search_productsLegacy discovery, retained for backward compatibility. Prefer search_catalog / lookup_catalog, then get_product. Filters by blind type, colour or maximum dimensions. Returns products with id (not product_id), name, description, features and in-stock colour count. Pass that id as product_id to get_price or configure_product.
submit_enquiryLegacy 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.
update_cartModify 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.
update_checkoutUpdate customer details or payment_method only before payment-link generation. Paid, cancelled and payment-in-progress checkouts are rejected. Concurrent state changes are detected; retrieve the latest status before retrying.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.CustomBlinds/cb-shop",
  "title": "Custom Blinds Shop",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "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."
        }
      ]
    }
  ],
  "version": "1.0.0",
  "repository": {
    "url": "https://github.com/CustomBlinds/cb-shop-mcp",
    "source": "github"
  },
  "description": "South Africa's first AI-transactable blinds, shutters and awnings catalogue with live ZAR pricing."
}