> 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/vs-code-github-copilot.md).

# VS Code / GitHub Copilot

VS Code makes MCP tools available to GitHub Copilot in the Chat view. Whale Coupons is a remote HTTP server, so you only give VS Code its URL.

## Option 1: guided setup

1. Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run **MCP: Add Server**.
2. Choose **HTTP**.
3. Enter the URL `https://whalecoupons.co/mcp`.
4. Enter the server ID `whale-coupons`.
5. Choose where to save it: the workspace `.mcp.json` (shared with the project) or your user configuration (all workspaces).

## Option 2: edit a config file

VS Code reads several files. They use two different top-level keys, so copy the block that matches your file.

**`.mcp.json` at the workspace root, or the Copilot user file `~/.copilot/mcp-config.json`** (top-level `mcpServers`):

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

**`.vscode/mcp.json`, or the user-profile `mcp.json` opened with MCP: Open User Configuration** (top-level `servers`):

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

VS Code's docs list `.mcp.json` and `~/.copilot/mcp-config.json` as the preferred locations for new servers. They can also be shared with other Copilot tools. `.vscode/mcp.json` still works and is needed only for VS Code-specific features such as input variables.

No `headers`, `inputs` or API key are needed.

## Use it

1. Open the Chat view (Ctrl+Cmd+I on macOS, Ctrl+Alt+I on Windows and Linux).
2. Select the **Configure Tools** button in the chat input and check that the Whale Coupons tools are enabled.
3. Ask: "Find coupon codes for coffee stores."

Copilot may ask you to confirm each tool call.

## Manage the server

Run **MCP: List Servers** to start, stop or restart the server, enable or disable it, or open its output log if something fails.

Source: VS Code docs, "Add and manage MCP servers in VS Code".
