# Connect DealScore to Claude Code

You connect DealScore to Claude Code by running claude mcp add --transport http dealscore https://cardealscore.com/api/mcp in a terminal, then running /mcp, selecting dealscore, and choosing Authenticate to finish the email sign-in. Claude Code registers a remote MCP server with `claude mcp add`. DealScore's transport is HTTP at `https://cardealscore.com/api/mcp`. The first `score_deal` call needs the OAuth sign-in.

Page: https://cardealscore.com/integrations/claude-code

Get a free API key: https://cardealscore.com/login?next=%2Fkeys. Used car price API: https://cardealscore.com/used-car-price-api

## Register the server

1. In a terminal, run the command below. The transport flag is http.
2. Open Claude Code in that project.
3. Run `/mcp`, select `dealscore`, and choose Authenticate.
4. Complete the DealScore email sign-in in the browser and approve access.
5. Ask Claude Code to call `score_deal` with a year, make, model, asking price, and mileage.

terminal:

```bash
claude mcp add --transport http dealscore https://cardealscore.com/api/mcp
```

Then run /mcp, pick dealscore, and choose Authenticate. Full setup: /integrations/claude-code.

## Quick answers

### What command adds DealScore to Claude Code?

claude mcp add --transport http dealscore https://cardealscore.com/api/mcp. The transport is HTTP.

### How does Claude Code sign in to DealScore?

With OAuth. Run /mcp, select dealscore, and choose Authenticate, then complete the email sign-in in the browser and approve access. dealscore has to show in /mcp before Authenticate is available.

### Does the Claude Code setup use an API key?

No. The add command uses OAuth. API keys are for curl and for MCP clients that send headers. Create one at /keys.

### Which tools does Claude Code get, and what do they cost?

score_deal, explain_grade, and health. Free includes 5 scored calls a month. Only results with coverage: scored count, and explain_grade and health are never metered.

## Keys stay on REST

This command uses OAuth. API keys are for curl and for MCP clients that send headers. Create one on https://cardealscore.com/keys, or follow the request example on https://cardealscore.com/used-car-price-api.

## If Authenticate does not finish

- The command includes `--transport http` and `https://cardealscore.com/api/mcp`.
- `/mcp` has to show dealscore before Authenticate is available. Re-run the add command in the project you opened.
- `coverage: cannot_score` means the connection worked and the comps were too thin to grade.

## What the agent can call

`score_deal` grades a deal. Send `asking_price` and `mileage`, plus a VIN or year, make, and model. `trim` and `zip` are optional. `explain_grade` maps a `delta_pct` to a grade without fetching comps. `health` reports coverage and limits. Free includes 5 scored calls a month and Builder is $19/mo (founding price) for 1,000 scored calls a month. Only `coverage: scored` counts, and `explain_grade` and `health` are never metered. Plans: https://cardealscore.com/pricing. Argument details: https://cardealscore.com/docs/api. Test arguments in the browser first: https://cardealscore.com/try.

## Other clients

[Cursor](https://cardealscore.com/integrations/cursor), [VS Code](https://cardealscore.com/integrations/vs-code), [Claude Desktop](https://cardealscore.com/integrations/claude-desktop), [Codex](https://cardealscore.com/integrations/codex), [ChatGPT](https://cardealscore.com/integrations/chatgpt), [n8n](https://cardealscore.com/integrations/n8n). The REST call and a recorded response are on https://cardealscore.com/used-car-price-api. Every client is also listed on https://cardealscore.com/agents.