> For the complete documentation index, see [llms.txt](https://whalecoupons.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whalecoupons.gitbook.io/docs/faq.md).

# FAQ

## Do I need an account or API key?

No. The server at `https://whalecoupons.co/mcp` has no authentication. You don't need a Whale Coupons account, an API key or OAuth. When your client asks for an authentication type, choose "None", "No sign in" or "No authentication". `codes.json` is also free and open.

## Is it free?

Yes. There is no charge for the MCP server or for `codes.json`.

## Where do the codes come from?

From the stores themselves. A store has to approve Whale Coupons before it is listed. Whale Coupons then records the customer discount the store gives it, usually under the code `WHALECOUPONS`. Codes are not scraped from other coupon sites and not invented. The server only returns codes in the directory, and its instructions tell the model to state only codes the tools return. More on [how the codes work](https://whalecoupons.co/how-codes-work/) and [about Whale Coupons](https://whalecoupons.co/about/).

## Why do so many stores have the same code?

Most stores use one brand code, `WHALECOUPONS`. That is intended: it is the real customer discount each of those stores gave Whale Coupons. A few stores issue their own code, which is shown for that store.

## How often is the data updated?

The MCP server describes its data as "updated daily". `codes.json` has an `updated` field with the date it was generated. When a store changes or ends its offer, Whale Coupons updates or removes the store's page.

## Will a code always work?

Not always. Stores can change or end a discount, or limit it by product, region, minimum spend or date. Some entries list a minimum order (`min_order`). Always check the total at checkout. If a code fails, remove other discounts first and check for extra spaces.

## Which stores are covered?

2,500+ online stores, most of them independent brands that sell direct to customers, in 14 categories from Fashion and Beauty to Pets and Travel. Large general marketplaces are not covered. Browse [all stores](https://whalecoupons.co/stores/) or ask the assistant to run `list_categories`.

## Can the server buy things or change anything?

No. All five tools are read-only lookups. They can't place orders, track orders, log in to stores or change data. In MCP terms every tool is marked `readOnlyHint: true` and `destructiveHint: false`.

## What data does the server receive from me?

Only the tool arguments the assistant sends: a store name, domain, product URL, search words, a category or a limit. It doesn't need your name, email or any account details. See the site's [privacy policy](https://whalecoupons.co/privacy/) for details.

## Are the links affiliate links?

Yes. The `shop_link` returned by the tools, and the `url` field in `codes.json`, are affiliate links. Whale Coupons may earn a commission when you buy through them, at no extra cost to you. Each result also includes a link to the store's page on whalecoupons.co.

## Which MCP transport and protocol version does it use?

Streamable HTTP at `https://whalecoupons.co/mcp`, protocol version `2025-06-18`. The server advertises the `tools` capability only, with no resources or prompts.

## My client only supports local (stdio) servers. What can I do?

Use a stdio-to-HTTP bridge such as `mcp-remote` if your client supports running commands, or use a client with built-in remote MCP support. See [Quick start](https://whalecoupons.gitbook.io/docs/quick-start.md) for the clients covered in these docs.

## Where is the source of these docs?

On GitLab: [whalecoupons/whale-coupons-mcp](https://gitlab.com/whalecoupons/whale-coupons-mcp). The repository holds documentation and the Gemini CLI extension manifest. It does not contain the server code.
