> 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/overview.md).

# Overview

Whale Coupons MCP is a public, read-only [Model Context Protocol](https://modelcontextprotocol.io/) server. It lets an AI assistant such as Claude, ChatGPT, Cursor, VS Code with GitHub Copilot, Gemini CLI or Windsurf look up coupon codes from [Whale Coupons](https://whalecoupons.co/), a directory of discount codes for 2,500+ independent online stores.

Every code in the directory is issued to Whale Coupons by the store itself. The server only returns those codes. It never generates or guesses one.

## At a glance

|                      |                                                     |
| -------------------- | --------------------------------------------------- |
| Endpoint             | `https://whalecoupons.co/mcp`                       |
| Transport            | Streamable HTTP (remote server, nothing to install) |
| Authentication       | None. No account, sign-in or API key                |
| Tools                | 5, all read-only                                    |
| MCP protocol version | `2025-06-18`                                        |
| Server name          | `whale-coupons`                                     |
| Coverage             | 2,500+ independent online stores in 14 categories   |

## What you can ask

* "Is there a promo code for Saguaro Barefoot Shoes?"
* "Find a discount code for this product: https\://…"
* "Coupon codes for running shoes"
* "Which pet stores have at least 30% off?"

The assistant picks the right tool, calls the server and answers with the code, the discount, how to apply it, and a link to the store's page on Whale Coupons. See [Example prompts](https://whalecoupons.gitbook.io/docs/example-prompts.md) for more.

## What it does not cover

* Large general marketplaces. The directory lists independent stores, many of them brands that sell direct to customers.
* Price comparison, product reviews, order tracking or buying on your behalf.

## The five tools

| Tool                                                                                                      | Use it for                                                |
| --------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| [`find_coupons`](https://whalecoupons.gitbook.io/docs/tool-reference.md#find_coupons)                     | A named store, brand, domain or product URL               |
| [`search_stores`](https://whalecoupons.gitbook.io/docs/tool-reference.md#search_stores)                   | A product type or shopping category                       |
| [`get_store`](https://whalecoupons.gitbook.io/docs/tool-reference.md#get_store)                           | Full details for a store slug from an earlier result      |
| [`list_categories`](https://whalecoupons.gitbook.io/docs/tool-reference.md#list_categories)               | What kinds of stores are covered                          |
| [`list_largest_discounts`](https://whalecoupons.gitbook.io/docs/tool-reference.md#list_largest_discounts) | The biggest percentage-off codes, optionally per category |

## Next steps

* [Quick start](https://whalecoupons.gitbook.io/docs/quick-start.md): connect in under a minute and test the endpoint.
* Client setup: [Claude Desktop](https://whalecoupons.gitbook.io/docs/client-setup/claude-desktop.md), [Claude.ai](https://whalecoupons.gitbook.io/docs/client-setup/claude.ai-custom-connectors.md), [ChatGPT](https://whalecoupons.gitbook.io/docs/client-setup/chatgpt.md), [Cursor](https://whalecoupons.gitbook.io/docs/client-setup/cursor.md), [VS Code / GitHub Copilot](https://whalecoupons.gitbook.io/docs/client-setup/vs-code-github-copilot.md), [Gemini CLI](https://whalecoupons.gitbook.io/docs/client-setup/gemini-cli.md), [Windsurf](https://whalecoupons.gitbook.io/docs/client-setup/windsurf-devin-desktop.md).
* [Tool reference](https://whalecoupons.gitbook.io/docs/tool-reference.md): parameters and real example output.
* [Public data](https://whalecoupons.gitbook.io/docs/public-data.md): the free `codes.json` file and the open dataset.

{% hint style="info" %}
Store links returned by the server are affiliate links. Whale Coupons may earn a commission when you buy through them, at no extra cost to you. Each store sets its own discount and conditions, so confirm the total at checkout.
{% endhint %}
