Connect DealScore to Cursor

1. In the project, create or open .cursor/mcp.json. Cursor MCP settings can hold the same config.
2. Paste the config below. Leave headers out. The URL alone is what Cursor uses to start OAuth.
3. Save the file. Cursor discovers OAuth and opens a browser for the email sign-in.
4. Open the email link DealScore sends and approve access. Cursor then calls the server with the access token.
5. In agent chat, ask Cursor to call score_deal with a year, make, model, asking price, and mileage. ZIP is optional.

{
  "mcpServers": {
    "dealscore": {
      "url": "https://cardealscore.com/api/mcp"
    }
  }
}

No headers. Cursor discovers OAuth and opens a browser for the email sign-in. Full setup: /integrations/cursor.

Cursor's OAuth path above is the one to use. A client that cannot open a browser can send x-api-key instead. Create the key on /keys. Authorization: Bearer YOUR_KEY works in that header slot too.

{
  "mcpServers": {
    "dealscore": {
      "url": "https://cardealscore.com/api/mcp",
      "headers": { "x-api-key": "YOUR_KEY" }
    }
  }
}

• The OAuth config is a url and no headers. A header on that block skips the browser sign-in.
• Finish the email sign-in. An unfinished consent leaves score_deal unauthorized.
• coverage: cannot_score with a null grade means comps were too thin. The connection worked.
• score_quota_exceeded means the monthly cap is spent. The connection worked. Plans: /pricing.

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: /pricing. Argument details: /docs/api. Test arguments in the browser first: /try.

Claude Code, Claude Desktop, Codex, ChatGPT. The REST call and a recorded response are on /used-car-price-api. Every client is also listed on /agents.