# Whale Coupons

> Store-issued coupon codes from thousands of independent online stores, updated daily.

- name: co.whalecoupons/whale-coupons
- version: 1.1.1
- connection class: unknown (unknown)
- trust: 78/100
- quality: 89/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/co.whalecoupons%2Fwhale-coupons
- tools: https://api.protogrid.dev/v1/servers/co.whalecoupons%2Fwhale-coupons/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "whale-coupons": {
      "type": "http",
      "url": "https://whalecoupons.co/mcp"
    }
  }
}
```


## Trust

- hygiene: 100
- liveness: 26
- freshness: 100
- provenance: 100
- drivers: +repository +namespace-matches-repo +dns-namespace +website -unreachable(1 failures) +updated-1d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 89/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 5 of 5 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,375 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 2 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 5, about 1,375 tokens to load them all
- tool set hash: b4a4b7df3b9d8c78f7af400e93627c6f
- badge: [![protogrid quality](https://protogrid.dev/badge/co.whalecoupons/whale-coupons.svg)](https://protogrid.dev/servers/co.whalecoupons/whale-coupons)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://whalecoupons.co/mcp (streamable-http, auth none, reachable false, uptime30d 0.8888889)

## Packages

_none_

## Tools (5)

- `find_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.
- `get_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.
- `list_categories`: 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.
- `list_largest_discounts`: 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).
- `search_stores`: 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).