Connect

Connect DealScore to Codex

Codex adds DealScore with two commands. The server is Streamable HTTP at https://cardealscore.com/api/mcp. codex mcp login runs the OAuth sign-in.

Add the server and sign in

  1. Run codex mcp add with the URL below. That writes [mcp_servers.dealscore] to ~/.codex/config.toml.
  2. Run codex mcp login dealscore. The browser opens the DealScore email sign-in.
  3. Approve access.
  4. Ask Codex to call score_deal with a year, make, model, asking price, and mileage.

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.

Keys stay on REST

These commands use OAuth. An API key is for POST /api/score. Create one on /keys and see the curl example on /used-car-price-api.

If the tool is missing

  • Both commands have to succeed. codex mcp add writes the URL. codex mcp login dealscore stores the OAuth grant.
  • The config section is [mcp_servers.dealscore] in ~/.codex/config.toml.
  • coverage: cannot_score means the connection worked and the comps were too thin to grade.

What the agent can call

score_deal grades a deal. Send asking_price and mileage, plus a VIN or year, make, and model. trim and zip are optional. explain_grade maps a delta_pct to a grade without fetching comps. health reports coverage and limits. Free includes 5 scored calls a month and Builder is $19/mo (founding price) for 1,000 scored calls a month. Only coverage: scored counts, and explain_grade and health are never metered. Plans: /pricing. Argument details: /docs/api. Test arguments in the browser first: /try.

Other clients

Cursor, Claude Code, Claude Desktop, ChatGPT. The REST call and a recorded response are on /used-car-price-api. Every client is also listed on /agents.