Petalo Andino

[
  {
    "name": "add_to_cart",
    "description": "Add a product to the shopper's cart, which updates on screen immediately. A variant id names what to add on its own; otherwise, for a product with variants, pass the option value ids from get_product's \"options\" - and if the shopper has not chosen yet, ask them, or call show_variant to show one first. Adding does not start checkout - use proceed_to_checkout when they are ready to pay.",
    "inputSchema": {
      "type": "object",
      "required": [
        "product"
      ],
      "properties": {
        "qty": {
          "type": "integer",
          "description": "Quantity to add (default 1)"
        },
        "options": {
          "type": "object",
          "description": "Variant selection as {option name: value}, e.g. {\"Size\": \"M\", \"Colour\": \"Purple\"}. Matching ignores case. Omit for products without variants, or when a variant id was given.",
          "additionalProperties": {
            "type": "string"
          }
        },
        "product": {
          "type": "string",
          "description": "What to add: a variant id, or a product's id or permalink from search_catalog, browse_store or get_product."
        }
      }
    }
  },
  {
    "name": "apply_coupon",
    "description": "Apply a discount coupon code to the cart and report the resulting total.",
    "inputSchema": {
      "type": "object",
      "required": [
        "code"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "The coupon code to apply"
        }
      }
    }
  },
  {
    "name": "browse_store",
    "description": "Browse the store the way a shopper would. Called with no arguments it lists the categories the merchant features in the store navigation; called with a category permalink it lists that category's products, with name, price and a link. Stock is not included here - call get_product before adding anything from a category listing. Use it when the shopper is exploring rather than looking for something specific.",
    "inputSchema": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string",
          "description": "Category permalink from a previous browse_store call. Omit to list the categories."
        }
      }
    }
  },
  {
    "name": "cancel_cart",
    "description": "Empty the shopper's cart, removing every item and any coupon. ALWAYS confirm with the shopper first: this discards everything they chose and cannot be undone. To remove a single line use update_cart_item with qty 0 instead.",
    "inputSchema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "estimate_shipping",
    "description": "What the store can ship to a destination and what it costs, for the cart as it stands. Ask for it when the shopper wants to know the delivery cost or time before they check out - it is the question that most often decides whether they finish. Needs a country and a region; a postal code makes the estimate exact where the store charges by it.",
    "inputSchema": {
      "type": "object",
      "required": [
        "country",
        "region"
      ],
      "properties": {
        "city": {
          "type": "string",
          "description": "City, when known"
        },
        "postal": {
          "type": "string",
          "description": "Postal or ZIP code, when known"
        },
        "region": {
          "type": "string",
          "description": "Region, state or province, as the store's checkout names it"
        },
        "country": {
          "type": "string",
          "description": "Two-letter ISO 3166-1 country code, e.g. PT, CL, US"
        },
        "municipality": {
          "type": "string",
          "description": "Municipality, where the store uses one"
        }
      }
    }
  },
  {
    "name": "get_cart",
    "description": "Read the shopper's current cart: line items, quantities, discounts, shipping and total. This is the same cart shown on screen, so read it before answering anything about what they are buying rather than relying on what was said earlier in the conversation.",
    "inputSchema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "get_product",
    "description": "Get one product's details, OR open it in the browser. Returns description, price, stock, and for a product with variants every option and the values it accepts under \"options\" - not the combinations themselves; use show_variant for a specific one. Set navigate=true when the shopper wants to SEE the product (\"show me\", \"open\", \"view\", \"take me to\"). Leave it false, the default, when you need data to answer a question or to prepare an add_to_cart - the browser then stays where it is. Does NOT add anything to the cart; use add_to_cart for that.",
    "inputSchema": {
      "type": "object",
      "required": [
        "product"
      ],
      "properties": {
        "product": {
          "type": "string",
          "description": "The product's id or permalink, as returned by search_catalog or browse_store. A variant id is accepted too and answers about the product it belongs to."
        },
        "navigate": {
          "type": "boolean",
          "description": "Open the product page. Default false: the shopper stays where they are."
        }
      }
    }
  },
  {
    "name": "get_recommended_products",
    "description": "Products this store recommends alongside what is already in the cart. Use it to suggest genuinely related items before checkout.",
    "inputSchema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "proceed_to_checkout",
    "description": "Open checkout so the shopper can review and pay. Use it when they say they are done. You CANNOT place the order or enter payment details, and no tool here can: the shopper completes the purchase themselves. Once this returns, stop - do not navigate again and do not tell them the order was placed.",
    "inputSchema": {
      "type": "object",
      "properties": {}
    }
  },
  {
    "name": "search_catalog",
    "description": "Search this store's catalogue by keyword. Returns name, price, stock and a link for each match. Use this FIRST whenever the shopper names something specific they want. It does not open anything or change the cart: call get_product for detail, add_to_cart to buy.",
    "inputSchema": {
      "type": "object",
      "required": [
        "query"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "description": "Maximum results to return (default and maximum 20)"
        },
        "query": {
          "type": "string",
          "description": "What to search for, in the shopper's own words"
        }
      }
    }
  },
  {
    "name": "show_variant",
    "description": "Show one specific variant of a product on the page, chosen by its option values, and report its price and stock. Opens the product page with that variant selected, so the shopper sees what is being discussed. Use it after get_product to resolve a combination.",
    "inputSchema": {
      "type": "object",
      "required": [
        "product"
      ],
      "properties": {
        "options": {
          "type": "object",
          "description": "The values to show, as {option name: value}, e.g. {\"Size\": \"M\", \"Colour\": \"Purple\"}. Values come from get_product's \"options\"; matching ignores case, and a partial selection is fine: the first available variant matching it is shown.",
          "additionalProperties": {
            "type": "string"
          }
        },
        "product": {
          "type": "string",
          "description": "The product's id or permalink. A variant id may be given instead, and then options can be left out: it already names one variant."
        }
      }
    }
  },
  {
    "name": "update_cart_item",
    "description": "Change the quantity of a line already in the cart, or remove it by setting the quantity to 0. Use the cart_item_id from get_cart, not the product id.",
    "inputSchema": {
      "type": "object",
      "required": [
        "cart_item_id",
        "qty"
      ],
      "properties": {
        "qty": {
          "type": "integer",
          "description": "New quantity; 0 removes the line"
        },
        "cart_item_id": {
          "type": "integer",
          "description": "The line's cart_item_id from get_cart"
        }
      }
    }
  }
]