MCP · x402 · llms.txt

Vehicle data, agent-native

CSNB is built for both humans and machines. Agents discover the API through llms.txt and OpenAPI, call tools over MCP, and pay per lookup with crypto — no signup, no API key.

MCP install snippet Read the docs

MCP server

Two tools, one endpoint

🔎

vehicle_lookup

country + plate (or VIN) + state → normalized vehicle identity facts.

🌍

coverage

Lists live countries, states and development status so agents can plan queries.

🔌

Streamable HTTP

Remote MCP at https://api.csnb.net/mcp with Bearer auth.

📄

Machine-readable docs

llms.txt and OpenAPI published at the domain root.

{
  "mcpServers": {
    "csnb": {
      "type": "http",
      "url": "https://api.csnb.net/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Payments

x402 pay-per-call

The agent lane uses the x402 protocol: an unpaid lookup returns HTTP 402 Payment Required with an invoice containing the exact USDC amount and your receive address on Base. Pay the amount, poll for confirmation, and the same lookup returns the vehicle record. Each invoice has a unique micro-amount, so payments are matched on-chain without personal data. USDT (TRC20) is planned.

Flow

  1. GET /agent/check?country=AU&plate=2ER7ZB&state=VIC → 402 + invoice
  2. Send exactly amount_usdc USDC (Base) to the invoice address
  3. GET /agent/poll?id=<invoice> → paid
  4. Repeat the lookup with X-CSNB-Invoice: <id> → vehicle data

FAQ

Agent integration questions

Do agents need an API key?

For the MCP server, yes — a Bearer key (email us for one). For the x402 pay-per-call lane, no key is required: payment itself is the credential.

Which models can call it?

Any MCP client — Claude, ChatGPT/Codex-style agents, or custom frameworks with an MCP connector.

How much does an agent lookup cost?

0.25 USDC per successful lookup on Base. See pricing.

Put vehicle data in your agent's toolbox.

Start with the MCP install snippet, or try a pay-per-call lookup.

Request an agent key See pricing