Which agent clients have DealScore setup pages?

Cursor, VS Code, Claude Code, Claude Desktop, Codex, ChatGPT, and n8n. Any client that speaks MCP Streamable HTTP can use the same URL.

Do I need an API key to connect an agent?

No, when the client supports OAuth. API keys are for curl, scripts, and clients that cannot do OAuth, and you create them on /keys.

Is there a REST endpoint as well as MCP?

Yes. POST /api/score runs the same engine as score_deal. Send the key in x-api-key or Authorization: Bearer.

Which tools does an agent 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. MCP, REST, and /try share one meter per account.

Connect

Connect DealScore to your agent

You connect DealScore to an agent by adding the MCP URL https://cardealscore.com/api/mcp to your client with no headers and signing in once by email. Your agent gets score_deal, explain_grade, and health. Scripts and backends can call the same engine over REST with an API key.

Connect MCP API reference Try score_deal in the browser

Connect MCP

Streamable HTTP at https://cardealscore.com/api/mcp. Add the URL with no headers. The client discovers OAuth and opens a browser for the same email magic link used on /keys. Setup pages: Cursor, VS Code, Claude Code, Claude Desktop, Codex, ChatGPT, n8n. REST and a recorded response: /used-car-price-api.

Cursor .cursor/mcp.json

{
  "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.

VS Code .vscode/mcp.json

{
  "servers": {
    "dealscore": {
      "type": "http",
      "url": "https://cardealscore.com/api/mcp"
    }
  }
}

No headers. VS Code discovers OAuth and opens a browser for the email sign-in. Full setup: /integrations/vs-code.

Claude Code terminal

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

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

Claude Desktop Customize > Connectors

https://cardealscore.com/api/mcp

Add a custom connector with this URL and leave the OAuth fields empty. Claude asks you to sign in the first time it calls score_deal. Config-file setup: /integrations/claude-desktop.

Codex terminal

codex mcp add dealscore --url https://cardealscore.com/api/mcp
codex mcp login dealscore

This writes [mcp_servers.dealscore] to ~/.codex/config.toml and runs the OAuth sign-in. Full setup: /integrations/codex.

ChatGPT apps Developer mode

https://cardealscore.com/api/mcp

Turn on Developer mode in ChatGPT settings, add an app with this MCP URL, and sign in when asked. Full setup: /integrations/chatgpt.

n8n MCP Client Tool

Endpoint: https://cardealscore.com/api/mcp
Server Transport: HTTP Streamable
Authentication: Header Auth
Header name: x-api-key
Header value: YOUR_KEY

Create the key at /keys. A workflow run does not open a browser, so Header Auth is the path to use. Bearer Auth with the same key also works. Full setup: /integrations/n8n.

Clients that take a URL and headers MCP config

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

For clients without OAuth. Create a key at /keys. Authorization: Bearer YOUR_KEY also works. Claude Desktop's config file takes a command, not a URL: see /integrations/claude-desktop. REST example: /used-car-price-api.

Tools are score_deal, explain_grade, and health. Discovery files are public JSON: /.well-known/mcp/server-card.json. Endpoint details live on the API reference.

OAuth or an API key

OAuth is the default MCP path. See /auth. API keys stay for curl, scripts, and clients that cannot do OAuth.

Sign in to create an API key (email magic link). Create and revoke keys on /keys. Live scores share a Free meter of 5 scored deals per month across MCP, REST, and the /try playground. Details: /docs/api#get-a-key.

Score with curl

POST /api/score

Same as MCP score_deal. Send x-api-key or Authorization: Bearer.

Example output, illustrative numbers. Score a real listing.

curl -X POST https://cardealscore.com/api/score \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{"year":2019,"make":"Example","model":"Sedan","asking_price":20000,"mileage":40000}'

Explain and health examples stay on the API reference.

Pricing

Free includes 5 scored deals per month. Builder is $19/mo (founding price) for 1,000 scored calls a month. MCP, REST, and the /try playground share one meter per account, and only coverage: scored counts. Details on /pricing.

Quick answers

Which agent clients have DealScore setup pages?: Cursor, VS Code, Claude Code, Claude Desktop, Codex, ChatGPT, and n8n. Any client that speaks MCP Streamable HTTP can use the same URL.
Do I need an API key to connect an agent?: No, when the client supports OAuth. API keys are for curl, scripts, and clients that cannot do OAuth, and you create them on /keys.
Is there a REST endpoint as well as MCP?: Yes. POST /api/score runs the same engine as score_deal. Send the key in x-api-key or Authorization: Bearer.
Which tools does an agent 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. MCP, REST, and /try share one meter per account.

Compare car price APIs

Need raw listings, VIN decode, or history reports instead of a grade? Car price and deal APIs for AI agents compares six APIs on what they return, MCP, auth, and free tier.