whale-coupons

endpoint

https://whalecoupons.co/mcp

protocol

streamable-http ·2025-06-18

authentication

none observed

public key

none — nobody has proven they own this listing · is it yours? claim it

karma

0 · newcomer

Is whale-coupons live?

Partly — its last checks failed now and then (checked 1h ago). It answered 0% of checks over the last 30 days.

Is whale-coupons free to use?

Not measured yet.

What tools does whale-coupons have?

5 tools: find_coupons, search_stores, get_store, list_categories, list_largest_discounts.

Is whale-coupons safe to connect?

The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

• find_coupons unknown never probed

  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.

  mcp-tool

  123456789101112131415

  {
    "type": "object",
    "required": [
      "store"
    ],
    "properties": {
      "store": {
        "type": "string",
        "maxLength": 300,
        "minLength": 1,
        "description": "Store or brand name, website domain, or a product/store page URL, exactly as the user gave it. Examples: \"Saguaro Barefoot Shoes\", \"saguaro.com\", \"https://www.saguaro.com/products/...\". Do not add words like 'coupon' or 'code'."
      }
    },
    "additionalProperties": false
  }

  arguments 15 lines copy
• search_stores unknown never probed

  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).

  mcp-tool

  1234567891011121314151617181920212223242526272829303132333435363738

  {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 10,
        "maximum": 25,
        "minimum": 1,
        "description": "Maximum number of stores to return (1-25)."
      },
      "query": {
        "type": "string",
        "maxLength": 200,
        "description": "Product type, keyword or partial store name, e.g. \"running shoes\", \"skincare\", \"coffee\". Optional when category is given."
      },
      "category": {
        "enum": [
          "Automotive",
          "Baby & kids",
          "Beauty",
          "Electronics",
          "Fashion",
          "Food & drink",
          "Health & wellness",
          "Home & kitchen",
          "Learning",
          "Other",
          "Pets",
          "Sports & outdoors",
          "Toys & hobbies",
          "Travel"
        ],
        "type": "string",
        "description": "Optional. Restrict results to one category."
      }
    },
    "additionalProperties": false
  }

  arguments 38 lines copy
• get_store unknown never probed

  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.

  mcp-tool

  123456789101112131415

  {
    "type": "object",
    "required": [
      "slug"
    ],
    "properties": {
      "slug": {
        "type": "string",
        "maxLength": 120,
        "minLength": 1,
        "description": "Store slug exactly as returned in a previous result, e.g. \"airwheel-luggage\"."
      }
    },
    "additionalProperties": false
  }

  arguments 15 lines copy
• list_categories unknown never probed

  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.

  mcp-tool

  12345

  {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  }

  arguments 5 lines copy
• list_largest_discounts unknown never probed

  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).

  mcp-tool

  12345678910111213141516171819202122232425262728293031323334353637383940

  {
    "type": "object",
    "properties": {
      "limit": {
        "type": "integer",
        "default": 10,
        "maximum": 25,
        "minimum": 1,
        "description": "Maximum number of stores to return (1-25)."
      },
      "category": {
        "enum": [
          "Automotive",
          "Baby & kids",
          "Beauty",
          "Electronics",
          "Fashion",
          "Food & drink",
          "Health & wellness",
          "Home & kitchen",
          "Learning",
          "Other",
          "Pets",
          "Sports & outdoors",
          "Toys & hobbies",
          "Travel"
        ],
        "type": "string",
        "description": "Optional. Restrict results to one category."
      },
      "min_discount": {
        "type": "number",
        "default": 15,
        "maximum": 100,
        "minimum": 0,
        "description": "Minimum percentage off, 0-100. Default 15. Use the number the user mentions, e.g. 30 for 'at least 30% off'."
      }
    },
    "additionalProperties": false
  }

  arguments 40 lines copy

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.