vindex-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VINDEX_API_URL | No | Override the API base URL. | https://api.vindexapi.dev |
| EVM_PRIVATE_KEY | 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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_healthA | Check Vindex API health and configured payment mode (live|mock). Free, no wallet or API key required. |
| get_pricingA | 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. |
| get_sampleA | 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. |
| decode_vinA | 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. |
| get_recallsA | 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. |
| get_known_issuesA | 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. |
| get_purchase_costsA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
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.