Whale Coupons

AI-assistant access to real discount codes from thousands of independent online stores. Look up by store, URL or category. Read-only, no sign-in. Remote MCP server: https://whalecoupons.co/mcp

GitHub

Hosted MCP Server

npx add-mcp 'https://whalecoupons.co/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Whale Coupons MCP: coupon codes for your AI shopping assistant

Real coupon codes, promo codes and discount codes for thousands of independent online stores, available inside Claude, ChatGPT, Cursor or any MCP client.

Whale Coupons is a coupon directory for independent brands, many of them Shopify stores that sell direct to customers. The stores issue every code to Whale Coupons themselves, and the directory is updated daily. This repository documents the public remote MCP server, so an AI assistant can look up a working code before you check out. It contains documentation only.

Connect

Endpoint (Streamable HTTP, no sign-in, no API key):

https://whalecoupons.co/mcp

Claude Code

claude mcp add --transport http whale-coupons https://whalecoupons.co/mcp

Cursor, VS Code and other clients that use an mcpServers JSON config

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

Claude.ai / ChatGPT: add a custom connector and paste the endpoint URL above.

Tools

Tool	What it does
`find_coupons`	Find the coupon code for a store by name, website domain or product URL
`search_stores`	Find stores with discount codes for a product type or category (e.g. "running shoes", "skincare")
`get_store`	Full code details for one store from an earlier result
`list_categories`	List store categories with links to each category page
`list_largest_discounts`	Stores with the biggest percentage-off codes, optionally within a category

All tools are read-only. The server only returns codes the stores have actually issued and never invents a code. Codes can carry store conditions (minimum order, region, dates), so check your total at checkout.

Example prompts

"Is there a promo code for Saguaro Barefoot Shoes?"
"Find a discount code for this product: "
"Biggest beauty discounts right now"
"Any coupon codes for pet stores?"
"Which independent stores have Black Friday codes?"

Disclosure

Shop links returned by the server are affiliate links. Whale Coupons may earn a commission at no extra cost to you.