`decode_vin`

Pack: nhtsa · Endpoint: https://gateway.pipeworx.io/nhtsa/mcp

Decode a VIN to get vehicle details. Returns make, model, year, body style, engine type, and safety ratings. E.g., ‘1HGBH41JXMN109186’.

Parameters

Name	Type	Required	Description
`vin`	string	yes	17-character VIN (e.g., “1HGBH41JXMN109186”)

Example call

Arguments

{
  "vin": "1HGBH41JXMN109186"
}

curl

curl -X POST https://gateway.pipeworx.io/nhtsa/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"decode_vin","arguments":{"vin":"1HGBH41JXMN109186"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('decode_vin', {
  "vin": "1HGBH41JXMN109186"
});

More examples

{
  "vin": "5TDJKRFH4LS123456"
}

Response shape

Always returns: vin, make, model, model_year, trim, vehicle_type, body_class, doors, drive_type, fuel_type_primary, engine_cylinders, engine_displacement_l, transmission, plant_country, manufacturer, all_attributes

Field	Type	Description
`vin`	string	VIN in uppercase
`make`	string \| null	Vehicle make/manufacturer name
`model`	string \| null	Vehicle model name
`model_year`	string \| null	Model year
`trim`	string \| null	Vehicle trim level
`vehicle_type`	string \| null	Type of vehicle
`body_class`	string \| null	Body class/style
`doors`	string \| null	Number of doors
`drive_type`	string \| null	Drive type (AWD, FWD, RWD, etc.)
`fuel_type_primary`	string \| null	Primary fuel type
`engine_cylinders`	string \| null	Number of engine cylinders
`engine_displacement_l`	string \| null	Engine displacement in liters
`transmission`	string \| null	Transmission style
`plant_country`	string \| null	Country where vehicle was manufactured
`manufacturer`	string \| null	Manufacturer name
`all_attributes`	object	All decoded attributes as key-value pairs

Full JSON Schema

{
  "type": "object",
  "properties": {
    "vin": {
      "type": "string",
      "description": "VIN in uppercase"
    },
    "make": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle make/manufacturer name"
    },
    "model": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle model name"
    },
    "model_year": {
      "type": [
        "string",
        "null"
      ],
      "description": "Model year"
    },
    "trim": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle trim level"
    },
    "vehicle_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Type of vehicle"
    },
    "body_class": {
      "type": [
        "string",
        "null"
      ],
      "description": "Body class/style"
    },
    "doors": {
      "type": [
        "string",
        "null"
      ],
      "description": "Number of doors"
    },
    "drive_type": {
      "type": [
        "string",
        "null"
      ],
      "description": "Drive type (AWD, FWD, RWD, etc.)"
    },
    "fuel_type_primary": {
      "type": [
        "string",
        "null"
      ],
      "description": "Primary fuel type"
    },
    "engine_cylinders": {
      "type": [
        "string",
        "null"
      ],
      "description": "Number of engine cylinders"
    },
    "engine_displacement_l": {
      "type": [
        "string",
        "null"
      ],
      "description": "Engine displacement in liters"
    },
    "transmission": {
      "type": [
        "string",
        "null"
      ],
      "description": "Transmission style"
    },
    "plant_country": {
      "type": [
        "string",
        "null"
      ],
      "description": "Country where vehicle was manufactured"
    },
    "manufacturer": {
      "type": [
        "string",
        "null"
      ],
      "description": "Manufacturer name"
    },
    "all_attributes": {
      "type": "object",
      "description": "All decoded attributes as key-value pairs",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "required": [
    "vin",
    "make",
    "model",
    "model_year",
    "trim",
    "vehicle_type",
    "body_class",
    "doors",
    "drive_type",
    "fuel_type_primary",
    "engine_cylinders",
    "engine_displacement_l",
    "transmission",
    "plant_country",
    "manufacturer",
    "all_attributes"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "nhtsa": {
      "url": "https://gateway.pipeworx.io/nhtsa/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

decode_vin