Whale Coupons

Use this when the user wants a coupon, promo, discount or voucher code for a specific online store or brand, or shares a store's website or product page URL and asks about saving on it. Accepts a store name ("Airwheel Luggage"), a domain ("airwheel-luggage.com") or a full product URL. Returns up to 3 matching stores, each with the code, the discount, how to apply it, minimum order if any, an affiliate shop link and the Whale Coupons store page. If no store has that name the result says so (found=false); when the words describe a product, stores that sell it may be returned instead (match="product"). Never invent or guess a code. Covers thousands of independent online stores, updated daily; large general marketplaces are not covered. For a product type rather than a store (e.g. "headphones") use search_stores. Do not use for price comparison, product reviews, order tracking or buying on the user's behalf.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "find_coupons",
    "arguments": {
      "store": "..."
    }
  }
}

Use this only when you already have a Whale Coupons store slug from an earlier result (the "slug" field, e.g. "airwheel-luggage") and need that store's full coupon details again. Returns the code, discount, how to apply it, minimum order if any, affiliate shop link and store page. For a store name, domain or URL use find_coupons instead.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_store",
    "arguments": {
      "slug": "..."
    }
  }
}

Use this when the user asks what kinds of stores or products Whale Coupons has codes for. Returns each category with its number of stores and its Whale Coupons page. Not needed before search_stores or list_largest_discounts, whose category parameter already lists the valid names.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_categories",
    "arguments": {}
  }
}

Use this when the user asks which stores have the biggest discounts or "best deals", optionally within a category (e.g. "biggest beauty discounts", "codes for at least 30% off"). Returns stores whose Whale Coupons code gives at least min_discount percent off, sorted from largest to smallest, with code, discount, how to apply it, affiliate shop link and store page. Fixed-amount discounts (e.g. $30 off) are not included because they can't be ranked by percentage. Do not use for a specific named store (use find_coupons).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_largest_discounts",
    "arguments": {}
  }
}

Use this when the user wants discount codes for a kind of product or a shopping category rather than one named store, for example "coupon for running shoes", "promo codes for skincare", "deals on coffee" or "discount codes for pet stores". Matches store names and the products each store lists on its own site first, then other stores in the categories the product words point to (e.g. headphones -> Electronics), and returns up to 25 stores with their code, discount, how to apply it, affiliate shop link and store page. Give query, category, or both. If nothing matches, the result names a category to try. Do not use for one named store (use find_coupons) or for ranking by size of discount (use list_largest_discounts).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "search_stores",
    "arguments": {}
  }
}