DealScore

npx add-mcp 'https://cardealscore.com/api/mcp'

Connect DealScore to your agent

Add one MCP URL to your client and sign in once. Your agent gets score_deal, explain_grade, and health. Scripts and backends can call the same engine over REST with an API key.

• HTML: https://cardealscore.com/agents
• Markdown: https://cardealscore.com/agents.md
• API docs: https://cardealscore.com/docs/api
• Auth: https://cardealscore.com/auth.md
• Pricing: https://cardealscore.com/pricing

Connect MCP

Streamable HTTP: https://cardealscore.com/api/mcp

Add that URL with no headers. The client discovers OAuth and opens a browser for the same email magic-link used on https://cardealscore.com/keys.

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: score_deal, explain_grade, health.

Server card: https://cardealscore.com/.well-known/mcp/server-card.json

OAuth or an API key

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

Sign in to create an API key. Email magic link, no password. Manage keys at https://cardealscore.com/keys. Live scores share a Free meter of 5 scored deals per month across MCP, REST, and the /try playground. Details: https://cardealscore.com/docs/api#get-a-key

Score with curl

curl -X POST https://cardealscore.com/api/score \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_KEY" \
  -d '{
    "year": 2020,
    "make": "Toyota",
    "model": "Camry",
    "asking_price": 18500,
    "mileage": 62000,
    "zip": "33803"
  }'

Explain, health, and the rest of the endpoints: https://cardealscore.com/docs/api.

To check arguments by hand before wiring an agent, use https://cardealscore.com/try. It bills the same meter.

Pricing

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