Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vindex-mcp Decode VIN 1FTFW1ET6EFA12345 and show warranty terms"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Vindex — Canada-aware, pay-per-call
vehicle intelligence for AI agents. Decode any 17-char VIN with its original
factory-warranty terms, read merged US (NHTSA) + Canada (Transport Canada) recalls,
get LLM-clustered known-issue reports (every issue cites a verified ODI complaint number,
with a bundled reliability-aggregates block), and itemized used-car closing costs for all
of Canada + all 50 US states & DC via one unified purchase-costs endpoint
(country=CA|US). Pay per call with USDC on Base via x402 — no signup, no
bundles, no receipts.
3 free tools — no wallet, no API key.
4 paid tools — flat per-call USD prices, settled in USDC on Base Mainnet via x402.
Try before you pay: the free get_sample tool returns every paid response shape for one
fixed sample vehicle (2013 Ford F-150).
{
"mcpServers": {
"vindex": {
"command": "npx",
"args": ["-y", "vindex-mcp"]
}
}
}You get get_health, get_pricing, get_sample.
Add an EVM wallet private key (0x-prefixed) that holds USDC on Base Mainnet:
{
"mcpServers": {
"vindex": {
"command": "npx",
"args": ["-y", "vindex-mcp"],
"env": { "EVM_PRIVATE_KEY": "0x..." }
}
}
}The paid tools (decode_vin, get_recalls, get_known_issues, get_purchase_costs)
then settle each call automatically.
Claude Code:
claude mcp add vindex -- npx -y vindex-mcp
# with a wallet:
claude mcp add vindex --env EVM_PRIVATE_KEY=0x... -- npx -y vindex-mcpClaude Desktop / Cursor: add the JSON block above to your MCP config
(claude_desktop_config.json or .cursor/mcp.json).
Related MCP server: @connskill/mcp-growth-services
Tool | Description |
| Vindex API health + configured payment mode (live | mock). |
| Endpoint catalog + per-call USD prices, params, networks, sources ( |
| A free sample of any paid response shape (decode / recalls / known-issues / purchase-costs) for the fixed sample vehicle. |
Tool | Endpoint | Price (USD) |
|
| $0.01 — normalized VIN decode + original factory-warranty terms (basic/powertrain/corrosion/roadside/EV-battery). |
|
| $0.01 — merged US + Canada recalls + full decoded vehicle. |
|
| $0.05 — LLM-clustered failure modes + bundled reliability block + full decode + complaintsAnalyzed. |
|
| $0.02 — unified itemized closing costs for Canada (provinces/territories) or the US (states + DC). |
Prices are flat per call — no bundles, no entitlements. Confirm live prices any time
with get_pricing. Purchase-costs is ONE endpoint selected by country=CA|US: CA requires
province (optional family_gift, buyer_has_plates), US requires state (optional
trade_in, local_rate).
Vindex speaks the x402 exact scheme. The API's 402 advertises a
Base (USDC, EIP-3009) rail; this MCP settles on Base:
The MCP requests a paid endpoint. With no payment, the API replies HTTP 402 with the accepted terms.
The MCP settles the call — via the standard @x402/fetch V2 client on a live API, or
the mock header when the API is in mode: mock — and retries.
The API returns the data plus a payment block (txHash, network, priceUsd, payer).
Compute-first, settle-after: Vindex computes the full answer before charging, so
you are never billed for an error, a validation failure, or a below-threshold answer
(e.g. get_known_issues refuses, uncharged, below 15 complaints).
get_health reports mode. When the API is in mock mode the paid tools work without
a wallet (a synthetic payer is used and no chain settlement occurs) — useful for trying
the full flow for free. In live mode the paid tools require EVM_PRIVATE_KEY with
USDC on Base Mainnet; a paid call without a key returns a clear error.
Variable | Required | Description |
| No | 0x-prefixed wallet key with USDC on Base Mainnet. Required to pay a live API. Free tools work without it; against a mock API the paid tools also work without it. |
| No | Override the API base URL (default |
Vindex provides informational vehicle data aggregated from public sources (NHTSA, Transport Canada). It is not professional, legal, or purchasing advice, and is provided as-is without warranty. Recall/complaint data reflects the source databases at fetch time. Contains information licensed under the Open Government Licence – Canada. See https://api.vindexapi.dev/terms.txt.
Docs for agents: https://api.vindexapi.dev/llms.txt · full: https://api.vindexapi.dev/llms-full.txt
MIT © jcislo
Decode any 17-char VIN via NHTSA vPIC — normalized make/model/year/engine/body/drive — PLUS a factory-warranty block giving the ORIGINAL new-vehicle warranty terms as sold (basic/powertrain/corrosion/roadside/EV-battery), keyed off the decoded make + model-year (NOT warranty-remaining; excludes extended-warranty campaigns, recalls, and emissions warranties). Costs $0.01 per call. Pays USDC on Base via x402. Compute-first, settle-after: Vindex computes the full answer BEFORE charging, so you are never billed for an error or a below-threshold answer. Requires EVM_PRIVATE_KEY with USDC on Base Mainnet when the API is in live mode.
Inputs: vin (required).
Check Vindex API health and configured payment mode (live|mock). Free, no wallet or API key required.
Inputs: no named parameters.
LLM-clustered named failure modes for a VIN, grounded in NHTSA ODI complaints — every issue cites verified complaint numbers (hallucination-gated). ALSO bundles a reliability-aggregates block (top components, severity signals, US + Canada recall counts incl. Canadian units affected), the full decoded vehicle, and complaintsAnalyzed (the stratified sample size the LLM saw vs the total complaintCount). Costs $0.05 per call. Pays USDC on Base via x402. Refuses (uncharged) below 15 complaints — still returns the decode + reliability block for free. Compute-first, settle-after: Vindex computes the full answer BEFORE charging, so you are never billed for an error or a below-threshold answer. Requires EVM_PRIVATE_KEY with USDC on Base Mainnet when the API is in live mode.
Inputs: vin (required).
Get the Vindex endpoint catalog and per-call USD prices (GET /discovery): the full list of paid endpoints, their params, flat prices, accepted x402 network (Base, USDC), sources, and attribution. Use this to discover what you can buy and what it costs. Free, no wallet or API key required.
Inputs: no named parameters.
Itemized government-imposed used-vehicle closing costs, unified across Canada and the US via country=CA|US, with per-line sourceUrl + confidence. CA (all 10 provinces + 3 territories): provincial/territorial sales tax (PST/RST/QST/HST or GST-only) + transfer/registration/plate fees + inspection. US (all 50 states + DC): sales/use/excise tax, title, first-year registration, inspection, and dealer doc fee. Costs $0.02 per call. Pays USDC on Base via x402. Compute-first, settle-after: Vindex computes the full answer BEFORE charging, so you are never billed for an error or a below-threshold answer. Requires EVM_PRIVATE_KEY with USDC on Base Mainnet when the API is in live mode.
Inputs: price (required), country (required), sale_type (required), state, +5 more.
Merged US (NHTSA) + Canada (Transport Canada) recalls for a VIN — the only API merging both — with the full decoded vehicle folded in. Costs $0.01 per call. Pays USDC on Base via x402. Compute-first, settle-after: Vindex computes the full answer BEFORE charging, so you are never billed for an error or a below-threshold answer. Requires EVM_PRIVATE_KEY with USDC on Base Mainnet when the API is in live mode.
Inputs: vin (required).
Get a FREE sample Vindex response for one of the paid endpoint shapes, computed live for the fixed sample vehicle (2013 Ford F-150, VIN 1FTFW1ET5DFC10312). Use this to see the exact response shape before paying. Free, no wallet or API key required. kind picks which shape: decode (incl. factory-warranty block) | recalls | known-issues (incl. bundled reliability block) | purchase-costs (returns both CA + US).
Inputs: kind (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool serves a clearly distinct purpose: health, pricing, sample, decode, recalls, costs, and known issues. There is no overlap in primary functionality, and even the bundled data in get_known_issues does not conflict with the dedicated tools.
Tool names follow a consistent verb_noun snake_case pattern. Most use the get_ prefix, and decode_vin uses a different verb but still follows the same grammatical structure, making the set predictable and easy to navigate.
With 7 tools, the server is well-scoped for a VIN data API: 3 free discovery tools and 4 paid data endpoints. Each tool earns its place and the count is within the ideal 3-15 range.
The tool surface covers the full lifecycle of the VIN data domain: discovery (pricing, sample, health), core decoding, recalls, purchase costs, and known issues. No obvious gaps exist, as the sample tool explicitly enumerates the four paid endpoint shapes, all of which are implemented.
Canadian public-sector data and legal information for AI agents, paid per call in USDC over x402
Market data and web intelligence for AI agents, paid per call in USDC on Base via x402.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Pay-per-call tools for autonomous agents, settled in USDC on Base via x402.
