# 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](https://cardealscore.com/).

- HTML: https://cardealscore.com/agents
- Markdown: https://cardealscore.com/agents.md
- API docs: https://cardealscore.com/docs/api
- Auth: https://cardealscore.com/auth.md

## 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.

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

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](https://cardealscore.com/login). Email magic link — no password. Manage keys at https://cardealscore.com/keys. Live scores share a Free meter of 40 scored deals per month. Sign in on the homepage before live scoring. Details: https://cardealscore.com/docs/api#get-a-key

## Score with curl

```bash
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.

The homepage is a paste sandbox only. [Try a listing](https://cardealscore.com/) if you want the web form. It shares the Free meter.