# DealScore

> Grades a used car's asking price vs live market comps (grade + brief + risks).

Production: https://cardealscore.com

Content-Signal (robots.txt): search=yes, ai-input=yes, ai-train=no.
Agents may cite and summarize deal grades. Do not treat this corpus as granted for model training.

## Discovery (unauthenticated)

- API docs: https://cardealscore.com/docs/api
- API docs (markdown): https://cardealscore.com/docs/api.md
- Homepage markdown: https://cardealscore.com/index.md
- Auth: https://cardealscore.com/auth.md
- This file: https://cardealscore.com/llms.txt
- MCP server card: https://cardealscore.com/.well-known/mcp/server-card.json
- MCP well-known: https://cardealscore.com/.well-known/mcp
- MCP probe: https://cardealscore.com/.well-known/mcp.json
- OAuth protected resource: https://cardealscore.com/.well-known/oauth-protected-resource
- OAuth authorization server: https://cardealscore.com/.well-known/oauth-authorization-server
- API catalog: https://cardealscore.com/.well-known/api-catalog
- Agent skills: https://cardealscore.com/.well-known/agent-skills/index.json
- Health (no auth): https://cardealscore.com/api/health

Markdown twins: send `Accept: text/markdown` or fetch the `.md` URL (`/index.md`, `/docs/api.md`, `/auth.md`).

## API

- Web form (sign in for live scores): https://cardealscore.com/
- Health (no auth): GET https://cardealscore.com/api/health
- Score a deal (API key): POST https://cardealscore.com/api/score
- Explain a grade (API key): POST https://cardealscore.com/api/explain
- MCP Streamable HTTP (OAuth or API key): https://cardealscore.com/api/mcp

MCP auth (primary): OAuth 2.1 with PKCE. Add `https://cardealscore.com/api/mcp` and sign in in the browser. See https://cardealscore.com/auth.md.

REST and scripts: `x-api-key` or `Authorization: Bearer <key>`.

MCP tools: `score_deal`, `explain_grade`, `health`.

Sign in to create an API key: https://cardealscore.com/login (email magic link). 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