{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "api.synchronity.app",
    "site": "synchronity.app",
    "addresses": [
      {
        "address": "104.21.78.134",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/20",
          "country": "US"
        }
      },
      {
        "address": "172.67.222.30",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.208.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3035::6815:4e86",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3035::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3032::ac43:de1e",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3032::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.78.134",
          "172.67.222.30",
          "2606:4700:3035::6815:4e86",
          "2606:4700:3032::ac43:de1e"
        ],
        "first_seen": "2026-11-22T21:17:02.506Z",
        "last_seen": "2026-11-22T21:17:02.506Z",
        "checks": 1
      },
      {
        "addresses": [
          "104.21.78.134",
          "172.67.222.30",
          "2606:4700:3032::ac43:de1e",
          "2606:4700:3035::6815:4e86"
        ],
        "first_seen": "2026-11-21T17:19:02.606Z",
        "last_seen": "2026-11-21T17:19:02.606Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "synchronity-mcp",
      "version": "0.2.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=15552000; includeSubDomains"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.themewireco",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/themewireco/synchronity",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "40206",
    "server_name": "io.github.themewireco/synchronity",
    "url": "https://api.synchronity.app/mcp",
    "host": "api.synchronity.app",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T21:17:02.506Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "686858587cac0f3bbc632b0f076951835f2295cc8ce21b01219c3043552293ee",
    "first_listed_at": "2026-11-21T17:19:02.606Z",
    "created_at": "2026-11-21T12:10:02.313Z",
    "resolved_addresses": [
      "104.21.78.134",
      "172.67.222.30",
      "2606:4700:3035::6815:4e86",
      "2606:4700:3032::ac43:de1e"
    ]
  },
  "server": {
    "name": "io.github.themewireco/synchronity",
    "title": "Synchronity",
    "description": "Shop connected e-commerce stores: search, compare, cart, and checkout with buyer approval.",
    "version": "0.5.21",
    "registry_status": "active",
    "repository_url": "https://github.com/themewireco/synchronity",
    "website_url": "https://synchronity.app",
    "published_at": "2026-07-21T16:28:03.599Z",
    "updated_at": "2026-07-21T16:28:03.599Z",
    "first_seen": "2026-11-21T12:10:01.627Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "takes-payment"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:52:05.458Z"
  },
  "operator": {
    "key": "synchronity.app",
    "name": "synchronity.app",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 636,
    "first_check_in_window": "2026-11-21T17:19:02.606Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "686858587cac0f3bbc632b0f076951835f2295cc8ce21b01219c3043552293ee",
    "tools": 26,
    "resources": 4,
    "prompts": 0,
    "first_seen": "2026-11-21T17:19:03.217Z",
    "tool_names": [
      "list_sites",
      "search_products",
      "get_product",
      "get_product_reviews",
      "request_back_in_stock",
      "compare_products",
      "create_cart",
      "add_to_cart",
      "quick_checkout",
      "remove_from_cart",
      "set_cart_quantity",
      "apply_coupon",
      "get_cart",
      "get_active_cart",
      "set_shipping_address",
      "select_shipping_option",
      "execute_checkout",
      "get_order",
      "list_orders",
      "request_delegation",
      "submit_delegation_otp",
      "check_delegation",
      "get_payment_methods",
      "initiate_payment",
      "submit_payment_otp",
      "get_payment_status"
    ],
    "declared": {
      "tools": [
        {
          "name": "list_sites",
          "description": "List all registered e-commerce sites. Use this first to find a site by name (e.g. \"Pronto Partners\") and get its site_id, which is required by all other tools.",
          "inputSchema": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "sites"
            ],
            "properties": {
              "sites": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "site_id": {
                      "type": "string"
                    },
                    "platform": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "List connected stores",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "search_products",
          "description": "Find products on a registered store. To BROWSE a store's catalog (open-ended requests like \"what do they sell\", \"show me what's available\"), call with NO query — this returns the store's products. To SEARCH, pass `query` (a product name/keyword). Returns paginated products as an interactive card. ALWAYS translate a buyer's budget or price constraint into the price params on THIS call instead of filtering in your reply: \"under/below/within X\" or \"X budget\" → `max_price: X`; \"over/above/at least X\" → `min_price: X`; \"between X and Y\" → both. Likewise pass `in_stock: true` for \"available\"/\"in stock\" and `category` when they name one. The card renders exactly what this call returns, so the filter MUST be applied here — never fetch the full catalog and then narrow it in text. Call once with your best intent (browse OR a single query); if a real search is genuinely empty, ask the user to clarify rather than re-firing reworded queries. The card shows products, prices, IDs, and Add-to-cart controls — keep your text reply to one brief sentence and do not re-list what the card shows.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "description": "Page number (1-indexed, default: 1)"
              },
              "query": {
                "type": "string",
                "description": "Optional single search term (product name/keyword). OMIT to browse; for several names use `queries`."
              },
              "queries": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Search several product names at once (e.g. when the buyer lists multiple items). Returns all matches in ONE call/card instead of searching one at a time. Use `query` for a single search, `queries` for several, or omit both to browse."
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID (e.g., \"site_abc123\" or \"shopify_store_1\")"
              },
              "category": {
                "type": "string",
                "description": "Filter by product category (optional)"
              },
              "in_stock": {
                "type": "boolean",
                "description": "Filter to in-stock items only (default: false)"
              },
              "per_page": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Results per page (default: 20, max: 100)"
              },
              "max_price": {
                "type": "string",
                "description": "Maximum price filter in store currency, format: \"199.99\" (optional)"
              },
              "min_price": {
                "type": "string",
                "description": "Minimum price filter in store currency, format: \"19.99\" (optional)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "products"
            ],
            "properties": {
              "kind": {
                "const": "productList"
              },
              "siteId": {
                "type": "string"
              },
              "products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "productId",
                    "title",
                    "price",
                    "inStock"
                  ],
                  "properties": {
                    "url": {
                      "type": "string"
                    },
                    "image": {
                      "type": "string"
                    },
                    "price": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "inStock": {
                      "type": "boolean"
                    },
                    "addToCart": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "productId": {
                      "type": "string"
                    },
                    "hasOptions": {
                      "type": "boolean"
                    }
                  }
                }
              },
              "siteName": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Search products",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_product",
          "description": "Retrieve detailed information about a specific product including variants, pricing, images, and availability. May also return `addons` — customer-selectable options defined by the store (e.g. engraving, gift wrap, size add-ons). When a product has addons, present them to the buyer and collect every addon with `required: true` before calling add_to_cart; for any option carrying a `price_modifier`, show that surcharge so the buyer knows the added cost. The card already shows the product details to the user, so keep your text reply brief and do not re-describe what the card displays.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "product_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "product_id": {
                "type": "string",
                "description": "Product ID from the site (platform-specific format)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "productId",
              "title",
              "price",
              "inStock"
            ],
            "properties": {
              "url": {
                "type": "string"
              },
              "kind": {
                "const": "product"
              },
              "image": {
                "type": "string"
              },
              "price": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "images": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              },
              "siteId": {
                "type": "string"
              },
              "inStock": {
                "type": "boolean"
              },
              "addToCart": {
                "type": "object",
                "properties": {
                  "label": {
                    "type": "string"
                  },
                  "params": {
                    "type": "object"
                  },
                  "toolName": {
                    "type": "string"
                  }
                }
              },
              "productId": {
                "type": "string"
              },
              "description": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get product details",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_product_reviews",
          "description": "🔍 **RECOMMENDED STEP** — Fetch product reviews and authenticity consensus before making purchase decisions. Returns: average rating, trust score (0.0-1.0), review sentiment analysis, authenticity flags (fake reviews, seller issues, negative trends), and recent reviews with verified purchase status. Always call this for each product before adding to cart to verify quality and detect scams.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "product_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "description": "Page number (default: 1)"
              },
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Max reviews to return (default: 10)"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "product_id": {
                "type": "string",
                "description": "Product ID"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "reviews": {
                "type": "array",
                "items": {
                  "type": "object"
                }
              },
              "authenticity_consensus": {
                "type": "object",
                "properties": {
                  "flags": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "trust_score": {
                    "type": "number"
                  },
                  "average_rating": {
                    "type": "number"
                  },
                  "verified_percentage": {
                    "type": "number"
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Get product reviews",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "request_back_in_stock",
          "description": "Subscribe the buyer to a back-in-stock alert for an out-of-stock product. Use when the buyer asks to be notified/told/pinged when an item restocks (\"notify me when X is back\", \"let me know when it's in stock\"). Collect the buyer's email so the alert can reach them (without it only the demand is recorded for the merchant). The buyer is emailed when the product is next seen in stock. Returns whether an email alert was armed.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "product_id"
            ],
            "properties": {
              "email": {
                "type": "string",
                "description": "Buyer's email for the restock alert (recommended — without it no alert is sent)"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "product_id": {
                "type": "string",
                "description": "Product ID to watch"
              },
              "variant_id": {
                "type": "string",
                "description": "Specific variant to watch (optional)"
              },
              "product_title": {
                "type": "string",
                "description": "Product name, for a clearer alert + merchant view (optional)"
              }
            }
          },
          "outputSchema": {
            "type": "object"
          },
          "annotations": {
            "title": "Notify me when back in stock",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "compare_products",
          "description": "Compare products across multiple registered e-commerce sites simultaneously. Uses fail-open strategy: partial results from successful sites are returned even if some sites time out.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_ids",
              "query"
            ],
            "properties": {
              "query": {
                "type": "string",
                "description": "Search query for product comparison"
              },
              "category": {
                "type": "string",
                "description": "Filter by category (optional)"
              },
              "in_stock": {
                "type": "boolean",
                "description": "Filter to in-stock items only (optional)"
              },
              "site_ids": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "List of registered site IDs to compare across"
              },
              "max_price": {
                "type": "string",
                "description": "Maximum price filter (optional)"
              },
              "min_price": {
                "type": "string",
                "description": "Minimum price filter (optional)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "site_id": {
                      "type": "string"
                    },
                    "products": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "site_name": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Compare products across stores",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_cart",
          "description": "Create a new shopping cart for a specific site. Returns a cart_id. IMPORTANT: Reuse the active cart_id across multiple products in the same session. Do NOT call create_cart again if you already have a cart_id for this site in the chat history.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "currency": {
                "type": "string",
                "description": "ISO 4217 currency code (e.g., \"USD\", \"EUR\", \"GBP\"). Defaults to site currency."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array"
              },
              "cart_id": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Create cart",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "add_to_cart",
          "description": "Add a product variant (or base product) to an existing cart. Reuse the active cart_id from the chat history if one already exists. Only call create_cart first if no cart exists yet.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "email": {
                "type": "string",
                "description": "Buyer email; arms a back-in-stock alert for any out-of-stock item in items[]."
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "product_id",
                    "quantity"
                  ],
                  "properties": {
                    "addons": {
                      "type": "object"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    }
                  }
                },
                "description": "Add several products in ONE call instead of calling this tool repeatedly. Each entry: { product_id, quantity, variant_id?, addons? }. Out-of-stock items are reported; pass `email` to auto-arm a back-in-stock alert for them."
              },
              "addons": {
                "type": "object",
                "description": "Selected product add-ons as a map of addon_id -> chosen value(s). For select/radio/boolean pass a single value; for checkbox/multi pass an array; for text/number pass the value. Values for choice add-ons MUST come from the product's addons[].options[].value. Collect any addon with required:true before checkout."
              },
              "cart_id": {
                "type": "string",
                "description": "Cart ID to add the product to"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "quantity": {
                "type": "integer",
                "description": "Quantity to add (must be >= 1)"
              },
              "product_id": {
                "type": "string",
                "description": "Product ID to add"
              },
              "variant_id": {
                "type": "string",
                "description": "Optional product variant ID (e.g., for size/color selection)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Add item to cart",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "quick_checkout",
          "description": "Assemble checkout-ready cart(s) in ONE call for a multi-product (and optionally multi-store) request. Creates a cart per store, adds all items, and sets the shipping address — then returns the cart(s) with delivery options to choose. Use this when the buyer lists several products at once (optionally across stores) and/or gives their address up front, instead of calling create_cart/add_to_cart/set_shipping_address separately. Does NOT select delivery, check out, or pay — the buyer picks delivery (select_shipping_option) and approves checkout/payment per store afterward. Out-of-stock items are reported; pass customer.email to auto-arm a back-in-stock alert for them.",
          "inputSchema": {
            "type": "object",
            "required": [
              "items",
              "shipping_address"
            ],
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "site_id",
                    "product_id",
                    "quantity"
                  ],
                  "properties": {
                    "addons": {
                      "type": "object"
                    },
                    "site_id": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    }
                  }
                },
                "description": "Products to buy. Each entry: { site_id, product_id, quantity, variant_id?, addons? }. Items may span multiple stores (grouped by site_id)."
              },
              "customer": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "type": "string"
                  }
                },
                "description": "Optional buyer contact carried for checkout; customer.email arms back-in-stock alerts for out-of-stock items."
              },
              "shipping_address": {
                "type": "object",
                "required": [
                  "country_code"
                ],
                "properties": {
                  "city": {
                    "type": "string"
                  },
                  "state": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  },
                  "country_code": {
                    "type": "string",
                    "description": "2-letter ISO country code (required)."
                  }
                },
                "description": "Buyer delivery address (applied to every store)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "oneOf": [
              {
                "type": "object",
                "required": [
                  "kind",
                  "siteId",
                  "cartId",
                  "items",
                  "subtotal",
                  "total"
                ],
                "properties": {
                  "kind": {
                    "const": "checkout"
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "qty": {
                          "type": "number"
                        },
                        "image": {
                          "type": "string"
                        },
                        "title": {
                          "type": "string"
                        },
                        "itemId": {
                          "type": "string"
                        },
                        "lineTotal": {
                          "type": "string"
                        },
                        "unitPrice": {
                          "type": "string"
                        },
                        "removeAction": {
                          "type": "object",
                          "properties": {
                            "label": {
                              "type": "string"
                            },
                            "params": {
                              "type": "object"
                            },
                            "toolName": {
                              "type": "string"
                            }
                          }
                        },
                        "setQtyAction": {
                          "type": "object",
                          "properties": {
                            "label": {
                              "type": "string"
                            },
                            "params": {
                              "type": "object"
                            },
                            "toolName": {
                              "type": "string"
                            }
                          }
                        },
                        "variantTitle": {
                          "type": "string"
                        },
                        "addonsSummary": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "total": {
                    "type": "string"
                  },
                  "cartId": {
                    "type": "string"
                  },
                  "siteId": {
                    "type": "string"
                  },
                  "shipping": {
                    "type": "string"
                  },
                  "subtotal": {
                    "type": "string"
                  },
                  "shippingOptions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "cost": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        },
                        "optionId": {
                          "type": "string"
                        },
                        "description": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "selectedShippingId": {
                    "type": "string"
                  }
                }
              },
              {
                "type": "object",
                "required": [
                  "kind",
                  "carts"
                ],
                "properties": {
                  "kind": {
                    "const": "multiCart"
                  },
                  "carts": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "siteId",
                        "storeName",
                        "cartId",
                        "items"
                      ],
                      "properties": {
                        "error": {
                          "type": "string"
                        },
                        "items": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "qty": {
                                "type": "number"
                              },
                              "image": {
                                "type": "string"
                              },
                              "title": {
                                "type": "string"
                              },
                              "itemId": {
                                "type": "string"
                              },
                              "lineTotal": {
                                "type": "string"
                              },
                              "unitPrice": {
                                "type": "string"
                              },
                              "removeAction": {
                                "type": "object",
                                "properties": {
                                  "label": {
                                    "type": "string"
                                  },
                                  "params": {
                                    "type": "object"
                                  },
                                  "toolName": {
                                    "type": "string"
                                  }
                                }
                              },
                              "setQtyAction": {
                                "type": "object",
                                "properties": {
                                  "label": {
                                    "type": "string"
                                  },
                                  "params": {
                                    "type": "object"
                                  },
                                  "toolName": {
                                    "type": "string"
                                  }
                                }
                              },
                              "variantTitle": {
                                "type": "string"
                              },
                              "addonsSummary": {
                                "type": "string"
                              }
                            }
                          }
                        },
                        "cartId": {
                          "type": "string"
                        },
                        "siteId": {
                          "type": "string"
                        },
                        "subtotal": {
                          "type": "string"
                        },
                        "storeName": {
                          "type": "string"
                        },
                        "shippingOptions": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "cost": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "optionId": {
                                "type": "string"
                              },
                              "description": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            ]
          },
          "annotations": {
            "title": "Quick checkout (build carts)",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "remove_from_cart",
          "description": "Remove a line item from the cart. Requires the item_id from the cart contents.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "item_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string",
                "description": "Cart ID"
              },
              "item_id": {
                "type": "string",
                "description": "Line item ID from the cart (cart.items[].item_id)"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Remove item from cart",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "set_cart_quantity",
          "description": "Set a cart line's quantity (the server cart is the checkout source of truth, so this updates it live). Requires the item_id from the cart contents and the new absolute quantity. A quantity of 0 removes the line. Returns the updated cart card.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "item_id",
              "quantity"
            ],
            "properties": {
              "cart_id": {
                "type": "string",
                "description": "Cart ID"
              },
              "item_id": {
                "type": "string",
                "description": "Line item ID from the cart (cart.items[].item_id)"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "quantity": {
                "type": "integer",
                "description": "New absolute quantity for the line (>= 0; 0 removes the line)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Set item quantity",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "apply_coupon",
          "description": "Apply a discount or promotional code to the cart. Returns the updated cart with discount applied.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "Coupon or promotional code string"
              },
              "cart_id": {
                "type": "string",
                "description": "Cart ID"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Apply coupon",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_cart",
          "description": "Retrieve current cart contents, including items, pricing, discounts, and totals. The card already shows the line items and totals to the user, so keep your text reply to one brief sentence — do not re-list the cart contents.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string",
                "description": "Cart ID (optional if an active cart exists for the site)"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "View cart",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_active_cart",
          "description": "Retrieve the buyer's in-progress cart for a site (resumes a conversation). Call this before assuming a new cart when a shopping conversation continues or after a cart error. Returns the cart with its items rebuilt if the connector cart expired, or null if no cart exists.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "cart"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "discounts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "Resume active cart",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "set_shipping_address",
          "description": "Set the cart shipping destination (collected from the buyer) and return available shipping options with costs. Call after items are in the cart and before select_shipping_option. country_code is required; include postal_code/state for accurate rates.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "country_code"
            ],
            "properties": {
              "city": {
                "type": "string",
                "description": "City"
              },
              "state": {
                "type": "string",
                "description": "State/province/region code where carriers need it"
              },
              "cart_id": {
                "type": "string",
                "description": "Cart ID"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "postal_code": {
                "type": "string",
                "description": "Postal/ZIP code for accurate rates"
              },
              "country_code": {
                "enum": [
                  "AF",
                  "AX",
                  "AL",
                  "DZ",
                  "AS",
                  "AD",
                  "AO",
                  "AI",
                  "AQ",
                  "AG",
                  "AR",
                  "AM",
                  "AW",
                  "AU",
                  "AT",
                  "AZ",
                  "BS",
                  "BH",
                  "BD",
                  "BB",
                  "BY",
                  "BE",
                  "BZ",
                  "BJ",
                  "BM",
                  "BT",
                  "BO",
                  "BQ",
                  "BA",
                  "BW",
                  "BV",
                  "BR",
                  "IO",
                  "BN",
                  "BG",
                  "BF",
                  "BI",
                  "CV",
                  "KH",
                  "CM",
                  "CA",
                  "KY",
                  "CF",
                  "TD",
                  "CL",
                  "CN",
                  "CX",
                  "CC",
                  "CO",
                  "KM",
                  "CG",
                  "CD",
                  "CK",
                  "CR",
                  "CI",
                  "HR",
                  "CU",
                  "CW",
                  "CY",
                  "CZ",
                  "DK",
                  "DJ",
                  "DM",
                  "DO",
                  "EC",
                  "EG",
                  "SV",
                  "GQ",
                  "ER",
                  "EE",
                  "SZ",
                  "ET",
                  "FK",
                  "FO",
                  "FJ",
                  "FI",
                  "FR",
                  "GF",
                  "PF",
                  "TF",
                  "GA",
                  "GM",
                  "GE",
                  "DE",
                  "GH",
                  "GI",
                  "GR",
                  "GL",
                  "GD",
                  "GP",
                  "GU",
                  "GT",
                  "GG",
                  "GN",
                  "GW",
                  "GY",
                  "HT",
                  "HM",
                  "VA",
                  "HN",
                  "HK",
                  "HU",
                  "IS",
                  "IN",
                  "ID",
                  "IR",
                  "IQ",
                  "IE",
                  "IM",
                  "IL",
                  "IT",
                  "JM",
                  "JP",
                  "JE",
                  "JO",
                  "KZ",
                  "KE",
                  "KI",
                  "KP",
                  "KR",
                  "KW",
                  "KG",
                  "LA",
                  "LV",
                  "LB",
                  "LS",
                  "LR",
                  "LY",
                  "LI",
                  "LT",
                  "LU",
                  "MO",
                  "MG",
                  "MW",
                  "MY",
                  "MV",
                  "ML",
                  "MT",
                  "MH",
                  "MQ",
                  "MR",
                  "MU",
                  "YT",
                  "MX",
                  "FM",
                  "MD",
                  "MC",
                  "MN",
                  "ME",
                  "MS",
                  "MA",
                  "MZ",
                  "MM",
                  "NA",
                  "NR",
                  "NP",
                  "NL",
                  "NC",
                  "NZ",
                  "NI",
                  "NE",
                  "NG",
                  "NU",
                  "NF",
                  "MK",
                  "MP",
                  "NO",
                  "OM",
                  "PK",
                  "PW",
                  "PS",
                  "PA",
                  "PG",
                  "PY",
                  "PE",
                  "PH",
                  "PN",
                  "PL",
                  "PT",
                  "PR",
                  "QA",
                  "RE",
                  "RO",
                  "RU",
                  "RW",
                  "BL",
                  "SH",
                  "KN",
                  "LC",
                  "MF",
                  "PM",
                  "VC",
                  "WS",
                  "SM",
                  "ST",
                  "SA",
                  "SN",
                  "RS",
                  "SC",
                  "SL",
                  "SG",
                  "SX",
                  "SK",
                  "SI",
                  "SB",
                  "SO",
                  "ZA",
                  "GS",
                  "SS",
                  "ES",
                  "LK",
                  "SD",
                  "SR",
                  "SJ",
                  "SE",
                  "CH",
                  "SY",
                  "TW",
                  "TJ",
                  "TZ",
                  "TH",
                  "TL",
                  "TG",
                  "TK",
                  "TO",
                  "TT",
                  "TN",
                  "TR",
                  "TM",
                  "TC",
                  "TV",
                  "UG",
                  "UA",
                  "AE",
                  "GB",
                  "US",
                  "UM",
                  "UY",
                  "UZ",
                  "VU",
                  "VE",
                  "VN",
                  "VG",
                  "VI",
                  "WF",
                  "EH",
                  "YE",
                  "ZM",
                  "ZW"
                ],
                "type": "string",
                "description": "ISO-3166 alpha-2 country code (e.g. US)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "checkout"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "shipping": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "shippingOptions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "cost": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "optionId": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  }
                }
              },
              "selectedShippingId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Set shipping address",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "select_shipping_option",
          "description": "Select one of the shipping options returned by set_shipping_address. Binds the rate to the cart so the total includes shipping; call before execute_checkout so the hosted checkout opens pre-filled.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "option_id"
            ],
            "properties": {
              "cart_id": {
                "type": "string",
                "description": "Cart ID"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "option_id": {
                "type": "string",
                "description": "option_id from cart.shipping_options"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "kind",
              "siteId",
              "cartId",
              "items",
              "subtotal",
              "total"
            ],
            "properties": {
              "kind": {
                "const": "checkout"
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "qty": {
                      "type": "number"
                    },
                    "image": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "itemId": {
                      "type": "string"
                    },
                    "lineTotal": {
                      "type": "string"
                    },
                    "unitPrice": {
                      "type": "string"
                    },
                    "removeAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "setQtyAction": {
                      "type": "object",
                      "properties": {
                        "label": {
                          "type": "string"
                        },
                        "params": {
                          "type": "object"
                        },
                        "toolName": {
                          "type": "string"
                        }
                      }
                    },
                    "variantTitle": {
                      "type": "string"
                    },
                    "addonsSummary": {
                      "type": "string"
                    }
                  }
                }
              },
              "total": {
                "type": "string"
              },
              "cartId": {
                "type": "string"
              },
              "siteId": {
                "type": "string"
              },
              "shipping": {
                "type": "string"
              },
              "subtotal": {
                "type": "string"
              },
              "shippingOptions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "cost": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "optionId": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  }
                }
              },
              "selectedShippingId": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Select shipping option",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "execute_checkout",
          "description": "Execute checkout for a cart to create an order. Requires a buyer delegation token (from user auth) and a shipping address. The order is created UNPAID (status \"pending\"). IMPORTANT — do NOT stop here or just hand the user the payment_url. Immediately continue the in-chat payment flow: call get_payment_methods for the returned order_id, present the available channels to the buyer, and ask which they want to use; then drive initiate_payment → (submit_payment_otp if needed) → poll get_payment_status until the order is paid. The payment_url in the response is only a manual fallback if the buyer declines in-chat payment. Always offer to collect payment in the chat first.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "cart_id",
              "buyer_delegation_token",
              "customer_name",
              "customer_email",
              "customer_phone",
              "shipping_name",
              "shipping_line1",
              "shipping_city",
              "shipping_state",
              "shipping_postal_code",
              "shipping_country"
            ],
            "properties": {
              "notes": {
                "type": "string",
                "description": "Optional order notes"
              },
              "cart_id": {
                "type": "string",
                "description": "Cart ID to checkout"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "customer_name": {
                "type": "string",
                "description": "Full name of the customer placing the order"
              },
              "shipping_city": {
                "type": "string",
                "description": "Shipping city"
              },
              "shipping_name": {
                "type": "string",
                "description": "Recipient full name"
              },
              "customer_email": {
                "type": "string",
                "description": "Email address of the customer placing the order"
              },
              "customer_phone": {
                "type": "string",
                "description": "Customer contact / billing phone number (E.164 preferred, e.g. +233201234567)"
              },
              "shipping_line1": {
                "type": "string",
                "description": "Shipping address line 1 (street)"
              },
              "shipping_line2": {
                "type": "string",
                "description": "Shipping address line 2 (apt/suite) [optional]"
              },
              "shipping_phone": {
                "type": "string",
                "description": "Recipient phone for the shipping address (E.164 preferred); defaults to customer_phone if omitted"
              },
              "shipping_state": {
                "type": "string",
                "description": "Shipping state or province"
              },
              "shipping_country": {
                "enum": [
                  "AF",
                  "AX",
                  "AL",
                  "DZ",
                  "AS",
                  "AD",
                  "AO",
                  "AI",
                  "AQ",
                  "AG",
                  "AR",
                  "AM",
                  "AW",
                  "AU",
                  "AT",
                  "AZ",
                  "BS",
                  "BH",
                  "BD",
                  "BB",
                  "BY",
                  "BE",
                  "BZ",
                  "BJ",
                  "BM",
                  "BT",
                  "BO",
                  "BQ",
                  "BA",
                  "BW",
                  "BV",
                  "BR",
                  "IO",
                  "BN",
                  "BG",
                  "BF",
                  "BI",
                  "CV",
                  "KH",
                  "CM",
                  "CA",
                  "KY",
                  "CF",
                  "TD",
                  "CL",
                  "CN",
                  "CX",
                  "CC",
                  "CO",
                  "KM",
                  "CG",
                  "CD",
                  "CK",
                  "CR",
                  "CI",
                  "HR",
                  "CU",
                  "CW",
                  "CY",
                  "CZ",
                  "DK",
                  "DJ",
                  "DM",
                  "DO",
                  "EC",
                  "EG",
                  "SV",
                  "GQ",
                  "ER",
                  "EE",
                  "SZ",
                  "ET",
                  "FK",
                  "FO",
                  "FJ",
                  "FI",
                  "FR",
                  "GF",
                  "PF",
                  "TF",
                  "GA",
                  "GM",
                  "GE",
                  "DE",
                  "GH",
                  "GI",
                  "GR",
                  "GL",
                  "GD",
                  "GP",
                  "GU",
                  "GT",
                  "GG",
                  "GN",
                  "GW",
                  "GY",
                  "HT",
                  "HM",
                  "VA",
                  "HN",
                  "HK",
                  "HU",
                  "IS",
                  "IN",
                  "ID",
                  "IR",
                  "IQ",
                  "IE",
                  "IM",
                  "IL",
                  "IT",
                  "JM",
                  "JP",
                  "JE",
                  "JO",
                  "KZ",
                  "KE",
                  "KI",
                  "KP",
                  "KR",
                  "KW",
                  "KG",
                  "LA",
                  "LV",
                  "LB",
                  "LS",
                  "LR",
                  "LY",
                  "LI",
                  "LT",
                  "LU",
                  "MO",
                  "MG",
                  "MW",
                  "MY",
                  "MV",
                  "ML",
                  "MT",
                  "MH",
                  "MQ",
                  "MR",
                  "MU",
                  "YT",
                  "MX",
                  "FM",
                  "MD",
                  "MC",
                  "MN",
                  "ME",
                  "MS",
                  "MA",
                  "MZ",
                  "MM",
                  "NA",
                  "NR",
                  "NP",
                  "NL",
                  "NC",
                  "NZ",
                  "NI",
                  "NE",
                  "NG",
                  "NU",
                  "NF",
                  "MK",
                  "MP",
                  "NO",
                  "OM",
                  "PK",
                  "PW",
                  "PS",
                  "PA",
                  "PG",
                  "PY",
                  "PE",
                  "PH",
                  "PN",
                  "PL",
                  "PT",
                  "PR",
                  "QA",
                  "RE",
                  "RO",
                  "RU",
                  "RW",
                  "BL",
                  "SH",
                  "KN",
                  "LC",
                  "MF",
                  "PM",
                  "VC",
                  "WS",
                  "SM",
                  "ST",
                  "SA",
                  "SN",
                  "RS",
                  "SC",
                  "SL",
                  "SG",
                  "SX",
                  "SK",
                  "SI",
                  "SB",
                  "SO",
                  "ZA",
                  "GS",
                  "SS",
                  "ES",
                  "LK",
                  "SD",
                  "SR",
                  "SJ",
                  "SE",
                  "CH",
                  "SY",
                  "TW",
                  "TJ",
                  "TZ",
                  "TH",
                  "TL",
                  "TG",
                  "TK",
                  "TO",
                  "TT",
                  "TN",
                  "TR",
                  "TM",
                  "TC",
                  "TV",
                  "UG",
                  "UA",
                  "AE",
                  "GB",
                  "US",
                  "UM",
                  "UY",
                  "UZ",
                  "VU",
                  "VE",
                  "VN",
                  "VG",
                  "VI",
                  "WF",
                  "EH",
                  "YE",
                  "ZM",
                  "ZW"
                ],
                "type": "string",
                "description": "ISO 3166-1 alpha-2 country code (e.g., \"US\", \"GB\")"
              },
              "shipping_postal_code": {
                "type": "string",
                "description": "Shipping postal code"
              },
              "buyer_delegation_token": {
                "type": "string",
                "description": "Delegation token from buyer (OAuth-like flow)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "line_total": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "total": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                }
              },
              "status": {
                "type": "string"
              },
              "order_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Place order (checkout)",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_order",
          "description": "Retrieve details for an order by its ID, including items, status, shipping, and tracking information. Orders are buyer-private — pass `buyer_delegation_token` (the delegation token from this buyer's checkout approval) so the gateway can confirm the buyer owns this order. If checking if an order is paid: a status of 'pending' or 'pending_payment' means the order has NOT been paid. Do NOT assume that the vendor storefront has synchronization delays or database lag; treat 'pending' as unpaid. When an order is unpaid, offer to collect payment in the chat by starting the in-chat payment flow (get_payment_methods → initiate_payment → get_payment_status) rather than only pointing the user at the payment_url. Do not mark the purchase task as successful until the status updates to 'processing' or 'completed'.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id",
              "order_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "order_id": {
                "type": "string",
                "description": "Order ID"
              },
              "buyer_delegation_token": {
                "type": "string",
                "description": "The buyer's delegation token (from their checkout approval); required to read their order."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "number"
                    },
                    "line_total": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              },
              "total": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  }
                }
              },
              "status": {
                "type": "string"
              },
              "order_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Get order details",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_orders",
          "description": "List recent orders for a site, optionally filtered by status (pending, processing, completed, cancelled, refunded). Orders are buyer-private — pass `buyer_delegation_token` (from this buyer's checkout approval); only that buyer's orders are returned.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "page": {
                "type": "integer",
                "description": "Page number (1-indexed, default: 1)"
              },
              "status": {
                "enum": [
                  "pending",
                  "processing",
                  "completed",
                  "cancelled",
                  "refunded"
                ],
                "type": "string",
                "description": "Filter by order status"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID"
              },
              "per_page": {
                "type": "integer",
                "description": "Results per page (max 100, default: 20)"
              },
              "buyer_delegation_token": {
                "type": "string",
                "description": "The buyer's delegation token (from their checkout approval); required to list their orders."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "required": [
              "orders"
            ],
            "properties": {
              "orders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "quantity": {
                            "type": "number"
                          },
                          "line_total": {
                            "type": "object",
                            "properties": {
                              "amount": {
                                "type": "string"
                              },
                              "currency": {
                                "type": "string"
                              }
                            }
                          }
                        }
                      }
                    },
                    "total": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "string"
                        },
                        "currency": {
                          "type": "string"
                        }
                      }
                    },
                    "status": {
                      "type": "string"
                    },
                    "order_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "annotations": {
            "title": "List orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "request_delegation",
          "description": "Start the human delegation (approval) flow needed for checkout/payment. PREFERRED: pass the buyer's `email` — the gateway emails them a 6-digit code and returns a device_code; ask the user for the code and call submit_delegation_otp. This keeps approval fully in-chat (no link) and you never see the code, so you cannot approve on their behalf. If you omit `email`, it falls back to a browser approval link (device flow) which the user must open; then poll check_delegation. You can never approve a delegation yourself.",
          "inputSchema": {
            "type": "object",
            "required": [
              "site_id"
            ],
            "properties": {
              "email": {
                "type": "string",
                "description": "Buyer's email. When provided, a one-time approval code is emailed to them and approval happens in-chat via submit_delegation_otp (recommended)."
              },
              "scopes": {
                "type": "array",
                "items": {
                  "enum": [
                    "read_products",
                    "manage_cart",
                    "execute_checkout",
                    "read_orders"
                  ],
                  "type": "string"
                },
                "description": "Scopes to request (defaults to all four scopes)"
              },
              "site_id": {
                "type": "string",
                "description": "Site ID requiring delegation"
              },
              "marketing_opt_in": {
                "type": "boolean",
                "description": "Set true ONLY if the buyer explicitly agreed to receive marketing/deals emails (e.g. ticked the opt-in box). Subscribes their email to the consumer mailing list."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string"
              },
              "delivery": {
                "type": "string"
              },
              "user_code": {
                "type": "string"
              },
              "approvalUrl": {
                "type": "string"
              },
              "device_code": {
                "type": "string"
              },
              "delegation_token": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Request buyer approval",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "submit_delegation_otp",
          "description": "Submit the 6-digit code the buyer received by email (from request_delegation with an email) to approve the delegation in-chat. On success returns a delegation_token to use as buyer_delegation_token for checkout/payment. You cannot obtain this code yourself — the user must read it from their email and give it to you.",
          "inputSchema": {
            "type": "object",
            "required": [
              "device_code",
              "code"
            ],
            "properties": {
              "code": {
                "type": "string",
                "description": "The 6-digit code the buyer read from their email"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID (optional if DEFAULT_SITE_ID is set)"
              },
              "device_code": {
                "type": "string",
                "description": "device_code returned by request_delegation"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string"
              },
              "delivery": {
                "type": "string"
              },
              "user_code": {
                "type": "string"
              },
              "approvalUrl": {
                "type": "string"
              },
              "device_code": {
                "type": "string"
              },
              "delegation_token": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Submit approval code",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "check_delegation",
          "description": "Poll for human approval of a delegation request. When status is \"approved\", returns the delegation_token to use as buyer_delegation_token in execute_checkout.",
          "inputSchema": {
            "type": "object",
            "required": [
              "device_code"
            ],
            "properties": {
              "device_code": {
                "type": "string",
                "description": "device_code returned by request_delegation"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "status": {
                "type": "string"
              },
              "delivery": {
                "type": "string"
              },
              "user_code": {
                "type": "string"
              },
              "approvalUrl": {
                "type": "string"
              },
              "device_code": {
                "type": "string"
              },
              "delegation_token": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Check approval status",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "get_payment_methods",
          "description": "STEP 1 of the in-chat payment flow. Returns the payment channels available for an order (e.g. \"mobile_money\", \"card\") plus a `gateways` array of the enabled payment gateways (each with id, label, and its channels). When more than one gateway is listed, ask the buyer which they want to use and pass it as `gateway` to initiate_payment. Call this first, after an order exists. Then call initiate_payment with the chosen channel (and gateway if more than one). site_id falls back to DEFAULT_SITE_ID if omitted.",
          "inputSchema": {
            "type": "object",
            "required": [
              "order_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID (optional if DEFAULT_SITE_ID is set)"
              },
              "order_id": {
                "type": "string",
                "description": "Order ID to pay for"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "mobile_money_provider_labels": {
                "type": "object"
              }
            }
          },
          "annotations": {
            "title": "Get payment methods",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "initiate_payment",
          "description": "STEP 2 of the in-chat payment flow. Starts a payment session for an order and returns a PaymentSession with an `instruction` the agent renders in chat. REQUIRES a buyer_delegation_token — obtain it exactly like execute_checkout: call request_delegation, have the user approve in chat, then check_delegation to get the token (spending money always needs human approval). For channel \"mobile_money\" you MUST collect the buyer's `phone` (Ghana: 055… or +233…) and `provider` — use codes mtn, vod (Vodafone/Telecel), or tgo (AirtelTigo); aliases telecel→vod, tigo→tgo are accepted. ALWAYS quote the **Show this instruction to the buyer** line from the response verbatim (Paystack display_text). For channel \"card\", no phone/provider is needed; the response instruction contains an `authorization_url` you send the user to. After calling: if instruction.action == \"submit_otp\", ask the user for the OTP and call submit_payment_otp. If instruction.action == \"approve_on_phone\", tell the user to approve the prompt on their phone, then poll get_payment_status. If instruction.action == \"redirect\" (card), send the user the authorization_url, then poll get_payment_status.",
          "inputSchema": {
            "type": "object",
            "required": [
              "order_id",
              "channel"
            ],
            "properties": {
              "phone": {
                "type": "string",
                "description": "Buyer mobile-money phone number (required for channel \"mobile_money\")"
              },
              "channel": {
                "enum": [
                  "mobile_money",
                  "card"
                ],
                "type": "string",
                "description": "Payment channel chosen by the buyer (from get_payment_methods)"
              },
              "gateway": {
                "enum": [
                  "paystack",
                  "stripe",
                  "paypal"
                ],
                "type": "string",
                "description": "Payment gateway to use when the store has more than one enabled (see get_payment_methods.gateways[].id). Optional — defaults to the store's first enabled gateway."
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID (optional if DEFAULT_SITE_ID is set)"
              },
              "order_id": {
                "type": "string",
                "description": "Order ID to pay for"
              },
              "provider": {
                "enum": [
                  "mtn",
                  "vod",
                  "tgo",
                  "telecel",
                  "vodafone",
                  "tigo",
                  "airteltigo"
                ],
                "type": "string",
                "description": "Mobile-money provider (required for channel \"mobile_money\"). Codes: mtn, vod (Vodafone/Telecel), tgo (AirtelTigo)."
              },
              "buyer_delegation_token": {
                "type": "string",
                "description": "Delegation token from the buyer (from request_delegation/check_delegation). Required — payments always need human approval."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "message": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "instruction": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  },
                  "authorization_url": {
                    "type": "string"
                  }
                }
              },
              "payment_status": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Start payment",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "submit_payment_otp",
          "description": "STEP 3 (mobile_money only, when initiate_payment returned instruction.action == \"submit_otp\"). Submits the one-time password the buyer received to authorise the mobile-money charge. REQUIRES the same buyer_delegation_token used for initiate_payment. After submitting, poll get_payment_status until payment_status is \"paid\"/\"processing\" or \"failed\".",
          "inputSchema": {
            "type": "object",
            "required": [
              "order_id",
              "otp"
            ],
            "properties": {
              "otp": {
                "type": "string",
                "description": "One-time password entered by the buyer"
              },
              "site_id": {
                "type": "string",
                "description": "Registered site ID (optional if DEFAULT_SITE_ID is set)"
              },
              "order_id": {
                "type": "string",
                "description": "Order ID being paid for"
              },
              "buyer_delegation_token": {
                "type": "string",
                "description": "Delegation token from the buyer (same one used for initiate_payment). Required."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "message": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "instruction": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  },
                  "authorization_url": {
                    "type": "string"
                  }
                }
              },
              "payment_status": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Submit payment code",
            "readOnlyHint": false,
            "openWorldHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_payment_status",
          "description": "FINAL STEP of the in-chat payment flow. Returns the current PaymentSession for an order. Poll this (every ~5 seconds) after initiate_payment/submit_payment_otp until payment_status becomes \"paid\" or \"processing\" (success — the order is confirmed) or \"failed\" (tell the user; they can retry by initiating a new payment). Do NOT treat the purchase as complete until this returns \"paid\" or \"processing\". No delegation needed (read-only).",
          "inputSchema": {
            "type": "object",
            "required": [
              "order_id"
            ],
            "properties": {
              "site_id": {
                "type": "string",
                "description": "Registered site ID (optional if DEFAULT_SITE_ID is set)"
              },
              "order_id": {
                "type": "string",
                "description": "Order ID to check payment status for"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "message": {
                "type": "string"
              },
              "reference": {
                "type": "string"
              },
              "instruction": {
                "type": "object",
                "properties": {
                  "action": {
                    "type": "string"
                  },
                  "provider": {
                    "type": "string"
                  },
                  "authorization_url": {
                    "type": "string"
                  }
                }
              },
              "payment_status": {
                "type": "string"
              }
            }
          },
          "annotations": {
            "title": "Check payment status",
            "readOnlyHint": true,
            "openWorldHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "Synchronity product card",
          "uri": "ui://synchronity/product",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Interactive single-product card with quantity, addon pills, and Add to cart."
        },
        {
          "name": "Synchronity product list",
          "uri": "ui://synchronity/product-list",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Interactive product list with per-row quantity and Add to cart."
        },
        {
          "name": "Synchronity cart",
          "uri": "ui://synchronity/cart",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Interactive cart card with line items, totals, and remove actions."
        },
        {
          "name": "Synchronity multi-store cart",
          "uri": "ui://synchronity/multi-cart",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Rich cart card per store for a multi-store quick checkout."
        }
      ],
      "prompts": []
    },
    "instructions": "Synchronity is a shopping server for the e-commerce stores a user has connected to their Synchronity account. It covers product search and details, reviews, cart building, shipping options, coupons, checkout, payment status, and order history.\nCOVERAGE: these tools read only from connected stores, live from each merchant. Product data, prices, stock, and orders returned here are specific to this user's connected stores and are not derived from public web listings.\nSITE IDS: every tool except list_sites takes a site_id. list_sites returns the connected stores with their IDs and matches partial or approximate store names.\nBROWSING vs SEARCHING: search_products with no query returns the store's catalog, which is what an open-ended request for what a store carries needs. Passing a query searches for a specific product name or keyword. Price, category, and stock filters are applied server-side and change which products come back.\nCART: add_to_cart adds a line, set_cart_quantity sets a line's absolute quantity (0 removes it), and remove_from_cart drops a line. get_cart returns the authoritative totals including tax, shipping, and discounts, which is what checkout charges.\nRESUMING: get_active_cart(site_id) returns the buyer's in-progress cart for a store, so an interrupted or continued shopping session can pick up its existing items instead of starting over.\nCHECKOUT: checkout and payment complete only with the buyer's explicit approval, given as a one-time code emailed to them and entered by them. An order is complete when the payment status is paid or the order is processing or completed; any other status means it is not."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}