Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · Public Records

How to Use NHTSA vehicle data dictionary in Gemini CLI

Returns vehicle attribute definitions and data types, or the accepted values for a lookup attribute. Use it to explain decoded specifications and translate NHTSA error codes into readable messages.

Prompts to try with NHTSA vehicle data dictionary in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Use NHTSA vehicle data dictionary to retrieve the definitions and types of vehicle attributes. Add readable descriptions for the attributes our inventory importer currently stores.

NHTSA vehicle data dictionaryGemini CLI
Try asking
  • Use NHTSA vehicle data dictionary to look this up and give me the result as a table. Save the result in ./assets.

  • Pull the latest numbers from NHTSA vehicle data dictionary and tell me what changed since last week.

  • Check NHTSA vehicle data dictionary and summarize what you find in three bullet points.

  • Pull the newest data from NHTSA vehicle data dictionary and give me the result as a table.

How to set up NHTSA vehicle data dictionary in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run NHTSA vehicle data dictionary

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "alexandria",
        "model": "vpic-nhtsa-dot-gov/vehicles/list_variables",
        "input": {
          "variable": "<variable>"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds NHTSA vehicle data dictionary on Spiral, shows the price and runs it.

NHTSA vehicle data dictionary providers and prices

Spiral runs NHTSA vehicle data dictionary through Alexandria. Open a card for today's price, with every fee included.

AlexandriaPublic Records
NHTSA vPIC vehicle decoder · List variables
vpic-nhtsa-dot-gov/vehicles/list_variables

What can you do with NHTSA vehicle data dictionary in Gemini CLI?

Build vehicle reference tables and inventory checks from NHTSA's manufacturer records and VIN data. A coding agent can map the returned identifiers and attribute definitions into the project's existing data structures.

Check dealer inventory descriptions

Decode inventory VINs individually or in batches, compare reported vehicle identity with listing descriptions, and explain attributes through the dictionary. Resolve unfamiliar prefixes, manufacturers, makes, and models before flagging a mismatch.

Standardize fleet vehicle records

Enrich a business fleet's VIN records with available vehicle specifications. Reconcile manufacturer entities, prefixes, make names, and model names, then use attribute definitions to build consistent reporting categories.

Build a vehicle research reference database

Create reference tables for manufacturers, makes, models, VIN prefixes, and attribute definitions. Use single and batch VIN decoding to attach vehicle characteristics to research records and investigate inconsistent identifiers.

Build vehicle catalog selection lists

Start with manufacturer records, resolve their business identities and makes, and populate model selections. Add manufacturer prefix references and dictionary definitions so catalog editors can interpret vehicle categories consistently.

Reconcile commercial trailer intake

Research trailer manufacturers and their makes, models, and WMI prefixes before matching incoming business inventory. Decode individual VIN exceptions or intake batches, using dictionary definitions to interpret trailer attributes.

Maintain vehicle reference tables

Compare successive retrievals of manufacturer, make, model, prefix, and dictionary records. Review changed business details and reference values before updating a vehicle catalog.

Explain vehicle identification results

Turn individual or batch decode results into readable vehicle summaries. Explain manufacturer prefixes, compare model names, and translate attribute definitions and decode errors for inventory reviewers.

Questions about NHTSA vehicle data dictionary in Gemini CLI

Can Gemini CLI use NHTSA vehicle data dictionary?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run NHTSA vehicle data dictionary like any built-in tool.

How much does NHTSA vehicle data dictionary cost in Gemini CLI?

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need an Alexandria account to use NHTSA vehicle data dictionary in Gemini CLI?

No. Spiral runs NHTSA vehicle data dictionary on its own Alexandria account. You sign in to Spiral once and never paste a key.

How long does it take to set up NHTSA vehicle data dictionary in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while NHTSA vehicle data dictionary runs?

NHTSA vehicle data dictionary runs in the background. Gemini CLI starts the run, checks on it and gives you the json when it's ready.

Where does NHTSA get vPIC's information?

NHTSA codes manufacturer submissions into vPIC after reviewing them. The vehicle descriptions reflect manufacturer-reported information.

Does vPIC cover vehicles worldwide?

Its scope is vehicles intended for sale or importation into the United States. Foreign manufacturers can appear, but that does not make vPIC a complete catalog of their vehicles in other markets.

How far back does vPIC's vehicle coverage go?

NHTSA states that vPIC is intended for model years 1981 onward. Its API FAQ reports approximately 99% decoding confidence from 1995 onward for most major brands, which is a coverage estimate rather than a guarantee for every attribute.

How does new information reach vPIC?

Manufacturer submissions enter the data after NHTSA review. Freshness follows that submission and review process; a newly announced vehicle is not proof that its information has already been processed.

Does vPIC provide complete equipment information?

NHTSA explicitly says that missing decoded values do not mean a feature or technology is unavailable on the vehicle. Its records can therefore support an equipment check without establishing a complete installed-equipment list.

Get started

Start using NHTSA vehicle data dictionary in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options