webmcp-kurio.netlify.app

{
  "name": "search_products",
  "kind": "answer",
  "impl": "imperative",
  "description": "Search the Kurio product catalog by keyword, category, or tag. Returns matching products with id, name, price (in cents), category, a one-line description, stock, and tags. Use this to help a shopper find items.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "Free-text search across name, category, description, and tags. Pass an empty string to list everything."
      },
      "category": {
        "type": "string",
        "description": "Optional category filter (e.g. \"Home & Living\", \"Kitchen & Dining\", \"Office & Tech\", \"Apparel\", \"Toys & Games\")."
      }
    }
  },
  "page": "/"
}

{
  "name": "get_product",
  "kind": "answer",
  "impl": "imperative",
  "description": "Fetch full details for a single Kurio product by its numeric id or slug. Use this after search_products to get the long description and stock count before adding to a cart.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "number",
        "description": "The numeric product id returned by search_products."
      },
      "slug": {
        "type": "string",
        "description": "Alternative to productId: the kebab-case product slug."
      }
    }
  },
  "page": "/"
}

{
  "name": "list_categories",
  "kind": "answer",
  "impl": "imperative",
  "description": "List all product categories available in the Kurio store. Returns an array of category strings.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "add_to_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Add a quantity of a product to the shopper's cart on the Kurio marketplace. The cart is visible in the page UI. If the item is already in the cart, the quantity is increased. Returns the updated cart summary.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "number",
        "description": "The numeric product id to add."
      },
      "quantity": {
        "type": "number",
        "description": "How many to add. Defaults to 1.",
        "minimum": 1
      }
    },
    "required": [
      "productId"
    ]
  },
  "page": "/"
}

{
  "name": "view_cart",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return the current contents of the shopper's Kurio cart: line items, quantities, line totals, subtotal, shipping, and grand total (all in cents).",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "update_cart_quantity",
  "kind": "act",
  "impl": "imperative",
  "description": "Set the quantity of a specific product already in the Kurio cart. Removes the line if quantity is less than 1.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "number",
        "description": "The product id to update."
      },
      "quantity": {
        "type": "number",
        "description": "The new quantity. Use 0 or less to remove the item."
      }
    },
    "required": [
      "productId",
      "quantity"
    ]
  },
  "page": "/"
}

{
  "name": "remove_from_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Remove a product line entirely from the Kurio cart.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "productId": {
        "type": "number",
        "description": "The product id to remove."
      }
    },
    "required": [
      "productId"
    ]
  },
  "page": "/"
}

{
  "name": "clear_cart",
  "kind": "act",
  "impl": "imperative",
  "description": "Empty the entire Kurio cart. Use when the shopper wants to start over.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}

{
  "name": "checkout",
  "kind": "transact",
  "impl": "imperative",
  "description": "Place a demo order on the Kurio marketplace using the current cart contents. This is a fake purchase: NO real payment is taken and NO item ships. You must provide a shopper name, email, and shipping address. On success returns an order number that can be used to look up the order later. Ask the user for these details before calling this tool.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "customerName": {
        "type": "string",
        "description": "The shopper's full name."
      },
      "customerEmail": {
        "type": "string",
        "description": "A contact email for the order."
      },
      "shippingAddress": {
        "type": "string",
        "description": "A shipping street address (line 1 is fine for the demo)."
      }
    },
    "required": [
      "customerName",
      "customerEmail",
      "shippingAddress"
    ]
  },
  "page": "/"
}

{
  "name": "get_store_info",
  "kind": "answer",
  "impl": "imperative",
  "description": "Return a short description of the Kurio marketplace: what it sells, that it is WebMCP-enabled, that purchases are simulated, and the list of tools an agent can use. Good first call to orient yourself.",
  "inputSchema": {
    "type": "object",
    "properties": {}
  },
  "page": "/"
}