> 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/client-setup/cursor.md).

# Cursor

Cursor reads MCP servers from an `mcp.json` file. A remote server only needs a `url`.

## Global (all projects)

Create or edit `~/.cursor/mcp.json`:

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

## One project only

Put the same JSON in `.cursor/mcp.json` at the root of the project. Commit it if you want everyone working on the project to get the server.

If the file already has other servers, add the `"whale-coupons"` entry inside the existing `mcpServers` object.

No `headers` or `auth` block is needed. The server has no authentication.

## Check that it's connected

1. Open **Customize** in the sidebar and find **whale-coupons** in the MCP list. Use its toggle to turn it on or off.
2. In Agent chat, ask: "Use Whale Coupons to list the store categories."

Cursor asks for approval before running an MCP tool, unless your run mode allows it. Click the arrow next to the tool name to see the arguments it is sending.

## Troubleshooting

Open the Output panel (Cmd+Shift+U / Ctrl+Shift+U) and select **MCP Logs** to see connection errors and tool calls.

Source: Cursor docs, "Model Context Protocol (MCP)".
