For AI agents & builders

Plug your AI agent
into vehicle data

CarLogs runs a Model Context Protocol server. Connect Claude, ChatGPT, Cursor or any MCP client and your agent can decode a VIN, resolve a US or Canadian licence plate, and pull a full history report — paying from report credits you top up.

Get an API key → API reference

🛡️ Vehicle data only — never owner identity.

The server

Endpointhttps://carlogs.xyz/mcp
TransportStreamable HTTP · JSON-RPC 2.0
AuthBearer API key, or OAuth 2.1 (PKCE, auto-discovered)
Discoveryhttps://carlogs.xyz/.well-known/mcp.json

💡 Opening https://carlogs.xyz/mcp in a browser shows a small JSON descriptor — that's normal. MCP clients talk to it over POST, not a browser.

Set it up in 3 steps

2

Add the server to your agent

Pick your client. Replace YOUR_API_KEY with your key.

Claude Code / Desktop 
claude mcp add --transport http carlogs https://carlogs.xyz/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
Cursor · Windsurf · generic config 
{
  "mcpServers": {
    "carlogs": {
      "type": "http",
      "url": "https://carlogs.xyz/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
ChatGPT

Developer mode → Connectors → Add. URL https://carlogs.xyz/mcp, authentication Bearer, token = your API key.

3

Top up report credits

Decoding VINs and plates draws on prepaid lookup credits. A full history report costs one report credit ($13.95). Buy them on the dashboard, or let the agent run buy_report_credits — it returns a Stripe link for you to approve. Reports you already bought re-read at no charge.

Tools your agent gets

decode_vin

Full vehicle data for a VIN — decode, equipment, recalls, complaints, crash ratings, MPG, market value, cost to own.

1 lookup credit
lookup_plate

US or Canada plate → the vehicle (year, make, model) plus a token to buy the report. The VIN is withheld until purchase.

1 lookup · nothing on a miss
get_history_report

The full report — title & brands, odometer & rollback, accidents, salvage, theft, liens, per-VIN recalls, exact value.

1 report credit · $13.95
buy_report_credits

Returns a Stripe checkout link for a human to approve, then the credits land on your key.

no charge to call
account_balance

Lookup credits, Pro allowance and report credits remaining.

no charge

Good to know

🙌
Payments stay with a human.

An agent never handles a card. buy_report_credits returns a Stripe link you approve; the credits then sit on your key.

🛡️
Privacy by design.

Every response is vehicle data only. CarLogs never returns an owner's name, address or contact details — by policy and by law.

🔑
OAuth, or an API key.

Clients that prefer OAuth are auto-configured — the server advertises its endpoints and supports dynamic registration, PKCE and refresh tokens. Or just paste your API key as a bearer token.

🛒
Agentic commerce.

A machine-readable product feed lists what an agent can buy. OpenAI Instant Checkout / ACP delegated payment can be enabled once our merchant application is approved.

🔌
Prefer plain HTTP?

The same actions are a REST API with an OpenAPI spec you can hand to any framework.

Ready to connect your agent?

Grab a key, add the server, and your agent can check any car in the US or Canada.

Get an API key →