# DealScore

> Remote MCP server for AI agents. One tool, `score_deal`, grades a used car's asking price against live dealer comps (grade, 0-100 score, expected price band, 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
- Agents: https://cardealscore.com/agents
- Agents (markdown): https://cardealscore.com/agents.md
- Homepage markdown: https://cardealscore.com/index.md
- Used-car deal API pricing: https://cardealscore.com/pricing
- Used-car deal API pricing (markdown): https://cardealscore.com/pricing.md
- Auth: https://cardealscore.com/auth.md
- About (who runs DealScore, what data it keeps; not affiliated with DealerScore): https://cardealscore.com/about
- About (markdown, served at this URL only): https://cardealscore.com/about.md
- This file: https://cardealscore.com/llms.txt
- Full text of every markdown twin in one file: https://cardealscore.com/llms-full.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
- OpenAPI: https://cardealscore.com/openapi.json
- Agent skills: https://cardealscore.com/.well-known/agent-skills/index.json
- Health (no auth): https://cardealscore.com/api/health
- Used car price API: https://cardealscore.com/used-car-price-api
- Used car price API (markdown): https://cardealscore.com/used-car-price-api.md
- Cursor setup: https://cardealscore.com/integrations/cursor
- Cursor setup (markdown): https://cardealscore.com/integrations/cursor.md
- VS Code setup: https://cardealscore.com/integrations/vs-code
- VS Code setup (markdown): https://cardealscore.com/integrations/vs-code.md
- Claude Code setup: https://cardealscore.com/integrations/claude-code
- Claude Code setup (markdown): https://cardealscore.com/integrations/claude-code.md
- Claude Desktop setup: https://cardealscore.com/integrations/claude-desktop
- Claude Desktop setup (markdown): https://cardealscore.com/integrations/claude-desktop.md
- Codex setup: https://cardealscore.com/integrations/codex
- Codex setup (markdown): https://cardealscore.com/integrations/codex.md
- ChatGPT setup: https://cardealscore.com/integrations/chatgpt
- ChatGPT setup (markdown): https://cardealscore.com/integrations/chatgpt.md
- n8n setup: https://cardealscore.com/integrations/n8n
- n8n setup (markdown): https://cardealscore.com/integrations/n8n.md
- Try score_deal in the browser: https://cardealscore.com/try
- Try score_deal in the browser (markdown): https://cardealscore.com/try.md
- Guides: https://cardealscore.com/guides
- Guides (markdown): https://cardealscore.com/guides.md
- Is this car a good deal: https://cardealscore.com/guides/is-this-car-a-good-deal
- Is this car a good deal (markdown): https://cardealscore.com/guides/is-this-car-a-good-deal.md
- Car price and deal APIs for AI agents, compared: https://cardealscore.com/guides/car-pricing-apis-for-ai-agents
- Car price and deal APIs for AI agents (markdown): https://cardealscore.com/guides/car-pricing-apis-for-ai-agents.md
- DealScore grade vs KBB value vs CarGurus Deal Rating: https://cardealscore.com/guides/deal-score-vs-kbb-vs-cargurus
- DealScore grade vs KBB value vs CarGurus Deal Rating (markdown): https://cardealscore.com/guides/deal-score-vs-kbb-vs-cargurus.md
- How DealScore grades work: https://cardealscore.com/guides/how-deal-grades-work
- How DealScore grades work (markdown, with the grade band table): https://cardealscore.com/guides/how-deal-grades-work.md
- Score a deal by VIN: https://cardealscore.com/guides/vin-deal-score
- Score a deal by VIN (markdown): https://cardealscore.com/guides/vin-deal-score.md
- Score a car deal with an agent: https://cardealscore.com/guides/score-a-car-deal-with-an-agent
- Score a car deal with an agent (markdown): https://cardealscore.com/guides/score-a-car-deal-with-an-agent.md
- Used car recalls by model year (NHTSA data): https://cardealscore.com/data/used-car-recalls
- Used car recalls (markdown): https://cardealscore.com/data/used-car-recalls.md
- Used car recalls (CSV): https://cardealscore.com/data/used-car-recalls.csv

Markdown twins: send `Accept: text/markdown` or fetch the `.md` URL (`/index.md`, `/docs/api.md`, `/auth.md`, `/agents.md`, `/pricing.md`, `/about.md`, `/guides/is-this-car-a-good-deal.md`, `/guides/car-pricing-apis-for-ai-agents.md`, `/guides/deal-score-vs-kbb-vs-cargurus.md`, `/guides/how-deal-grades-work.md`, `/data/used-car-recalls.md`, `/guides.md`, `/guides/vin-deal-score.md`, `/guides/score-a-car-deal-with-an-agent.md`, `/used-car-price-api.md`, `/try.md`, `/integrations/cursor.md`, `/integrations/vs-code.md`, `/integrations/claude-code.md`, `/integrations/claude-desktop.md`, `/integrations/codex.md`, `/integrations/chatgpt.md`, `/integrations/n8n.md`). All of them in one file: https://cardealscore.com/llms-full.txt

## API

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

Client setup (Cursor, VS Code, Claude Code, Claude Desktop, Codex, ChatGPT apps, n8n): https://cardealscore.com/agents

Browser playground for testing `score_deal` arguments (same meter): https://cardealscore.com/try

Sign in to create an API key: https://cardealscore.com/login?next=%2Fkeys&from=key_agent (email magic link). Manage keys at https://cardealscore.com/keys. Live scores share a Free meter of 5 scored deals per month across MCP, REST, and /try. Builder is $19/mo (founding price) for 1,000 scored calls a month. Details: https://cardealscore.com/docs/api#get-a-key