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

# Quick start

## 1. Copy the endpoint

```
https://whalecoupons.co/mcp
```

That is all a client needs. The server speaks Streamable HTTP and has no authentication, so there is no API key, OAuth step or account to create. When a client asks for an authentication type, choose **None** / **No sign in** / **No authentication**.

## 2. Add it to your client

| Client                   | How                                                                         | Guide                                                                                         |
| ------------------------ | --------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| Claude Desktop           | Connectors → Add custom connector                                           | [Claude Desktop](https://whalecoupons.gitbook.io/docs/client-setup/claude-desktop.md)         |
| Claude.ai (web)          | Connectors → Add custom connector                                           | [Claude.ai](https://whalecoupons.gitbook.io/docs/client-setup/claude.ai-custom-connectors.md) |
| ChatGPT (web)            | Plugins → + → Add custom MCP server                                         | [ChatGPT](https://whalecoupons.gitbook.io/docs/client-setup/chatgpt.md)                       |
| Cursor                   | `~/.cursor/mcp.json`                                                        | [Cursor](https://whalecoupons.gitbook.io/docs/client-setup/cursor.md)                         |
| VS Code / GitHub Copilot | `.vscode/mcp.json` or `.mcp.json`                                           | [VS Code](https://whalecoupons.gitbook.io/docs/client-setup/vs-code-github-copilot.md)        |
| Gemini CLI               | `gemini extensions install …` or `gemini mcp add …`                         | [Gemini CLI](https://whalecoupons.gitbook.io/docs/client-setup/gemini-cli.md)                 |
| Windsurf (Devin Desktop) | `devin mcp add …` or `mcp_config.json`                                      | [Windsurf](https://whalecoupons.gitbook.io/docs/client-setup/windsurf-devin-desktop.md)       |
| Claude Code              | `claude mcp add --transport http whale-coupons https://whalecoupons.co/mcp` | this page                                                                                     |

Most JSON-configured clients accept some form of this entry. Field names differ by client, so use the guide for yours:

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

## 3. Ask for a code

Start a new chat with the server enabled and try:

> Is there a coupon code for Airwheel Luggage?

The assistant should call `find_coupons` and reply with the code, the discount (18% off when this page was written), how to apply it, and a link to the store's [Whale Coupons page](https://whalecoupons.co/stores/airwheel-luggage/).

## Test the endpoint without a client

You can call the server directly with `curl`. Each request is a JSON-RPC 2.0 message sent by `POST`.

**Initialize:**

```bash
curl -s https://whalecoupons.co/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'
```

The response includes:

```json
{
  "protocolVersion": "2025-06-18",
  "capabilities": { "tools": { "listChanged": false } },
  "serverInfo": {
    "name": "whale-coupons",
    "title": "Whale Coupons",
    "version": "1.1.0",
    "websiteUrl": "https://whalecoupons.co"
  }
}
```

**List the tools:**

```bash
curl -s https://whalecoupons.co/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'
```

**Call a tool:**

```bash
curl -s https://whalecoupons.co/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"find_coupons","arguments":{"store":"Airwheel Luggage"}}}'
```

You can also explore the server interactively with the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector): run `npx @modelcontextprotocol/inspector`, choose the Streamable HTTP transport and enter the endpoint URL.

## Troubleshooting

* **The client asks for OAuth or a client ID.** Pick the "no authentication" option. The server has no sign-in.
* **No tools appear.** Start a new chat or reload the client after adding the server, and check that the server is enabled for that chat.
* **The assistant answers from memory instead of calling the server.** Name it in the prompt, for example "Use Whale Coupons to find a code for …".
* **"No code found."** The store is not in the directory yet. Large general marketplaces are not covered. Browse [all stores](https://whalecoupons.co/stores/) to see what is.
