Agents

Connect DealScore to your agent

Add the MCP server, sign in with OAuth, or call REST with an API key. Same grade, brief, and risks as the web form.

Connect MCP

Streamable HTTP at 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 /keys.

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

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 40 scored deals per month. Sign in on the homepage before live scoring. Details: /docs/api#get-a-key.

Score with curl

POST /api/score
Same as MCP score_deal. Send x-api-key or Authorization: Bearer.
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 and health examples stay on the API reference.

The homepage is a paste sandbox only. Try a listing there if you want the web form. It shares the Free meter.