# Connect an AI assistant

> For the complete documentation index, see [llms.txt](https://usecarscout.com/docs/llms.txt).

Add the CarScout MCP server to Claude, Claude Code, Cursor, Windsurf, or another MCP client. Market data, recall, and VIN tools work without an account.

The CarScout MCP server is a remote server that uses the Streamable HTTP transport. Your client connects to this address:

```text
https://mcp.usecarscout.com/mcp
```

The market data, recall, and VIN tools work without sign-in. To create scouts and read their alerts, connect your CarScout account. For the ways to connect it, see [Authentication](https://usecarscout.com/docs/authentication).

## Claude Code

To add CarScout to Claude Code, run the following command:

```bash
claude mcp add carscout --transport http https://mcp.usecarscout.com/mcp
```

To use account tools, type `/mcp`, choose **carscout**, and choose **Authenticate**. Sign in to CarScout and allow access.

## Claude on the web and the desktop app

To add CarScout as a connector, follow these steps:

1. Open **Customize > Connectors**.
2. Click **Add**, and then click **Add custom connector**.
3. Enter `CarScout` as the name and `https://mcp.usecarscout.com/mcp` as the address, and then click **Add**.
4. Optional: To use account tools, click **Connect**, sign in to CarScout, and allow access.

## Cursor and Windsurf

Add the following server to your MCP configuration file:

```json
{
  "mcpServers": {
    "carscout": {
      "url": "https://mcp.usecarscout.com/mcp",
      "headers": {
        "Authorization": "Bearer CARSCOUT_API_KEY"
      }
    }
  }
}
```

Replace `CARSCOUT_API_KEY` with your CarScout API key. To use only the public tools, remove the `headers` object.

## Clients that run local servers only

If your client can only start local MCP servers, use `mcp-remote` to connect to the remote server:

```json
{
  "mcpServers": {
    "carscout": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.usecarscout.com/mcp?key=CARSCOUT_API_KEY"
      ]
    }
  }
}
```

Replace `CARSCOUT_API_KEY` with your CarScout API key. To use only the public tools, remove `?key=CARSCOUT_API_KEY`.

## Check the connection

Ask your assistant a market question, such as "How many 2021 Toyota RAV4s are listed, and what is their typical mileage?" It calls `get_market_data` and answers with the snapshot date.

To check account access, ask "How many scouts can I create?" The assistant calls `check_limits`.

## Prompts

Clients that support MCP prompts can use these:

- `car-search-strategy`: turns a budget and needs into a research plan.
- `vehicle-due-diligence`: checks one vehicle with VIN decoding, market context, and recalls.
- `scout-setup`: turns plain-English criteria into a scout.
- `alert-triage`: ranks a scout's alerts and decides what to dismiss.

## Disconnect

To disconnect, remove CarScout from your client. If you used an API key, revoke it in CarScout under **Settings > Account**.
