Server definition
- Hash
- sha256:e0d7868f9888b6bedc46d1d38a8cd3c0ef798b5bfe1769ea9ccb498c166a9ab6
- What it is
- What a remote MCP server returned when asked what it offers: 7 tools
The blob, as servednamed by its sha256
{
"instructions": "Use the nhtsa_* tools for U.S. vehicle safety data: recalls, complaints, NCAP crash ratings, defect investigations, and VIN decoding. nhtsa_get_vehicle_safety is the default for general 'is this car safe?' questions; nhtsa_lookup_vehicles confirms make/model spelling first.",
"tools": [
{
"description": "Decode a Vehicle Identification Number to extract make, model, year, body type, engine, safety equipment, and manufacturing details. Pass a single 17-character VIN string, or an array of up to 50 VINs for batch decode. Partial VINs accepted — use * for unknown positions.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"modelYear": {
"description": "Model year, a whole number. Helps resolve ambiguity for pre-1980 or partial VINs.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"vin": {
"anyOf": [
{
"description": "A single VIN string (up to 17 characters, * for unknown positions)",
"type": "string"
},
{
"description": "An array of up to 50 VINs for batch decode",
"items": {
"type": "string"
},
"type": "array"
}
],
"description": "A single 17-character VIN (e.g., \"1HGCM82633A004352\") or an array of up to 50 VINs for batch decode. Partial VINs accepted — use * for unknown positions."
}
},
"required": [
"vin"
],
"type": "object"
},
"name": "nhtsa_decode_vin",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"vehicles",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "Number of VINs decoded and the path taken (single or batch).",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `empty_vin_list`: No non-empty VIN strings supplied. `batch_too_large`: VIN array exceeds the batch limit. Other values are possible when a failure originates below the handler.",
"examples": [
"empty_vin_list",
"batch_too_large"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Present when one or more VINs decoded with VPIC warnings (errorCode != 0) — check errorCode/errorText per vehicle.",
"type": "string"
},
"vehicles": {
"description": "Decoded vehicle information per VIN",
"items": {
"additionalProperties": false,
"description": "Decoded details for a single VIN",
"properties": {
"abs": {
"description": "ABS availability",
"type": "string"
},
"airBagLocCurtain": {
"description": "Curtain airbag info",
"type": "string"
},
"airBagLocFront": {
"description": "Front airbag locations",
"type": "string"
},
"airBagLocKnee": {
"description": "Knee airbag info",
"type": "string"
},
"airBagLocSide": {
"description": "Side airbag locations",
"type": "string"
},
"bodyClass": {
"description": "Body class (e.g., \"Sedan/Saloon\", \"SUV\")",
"type": "string"
},
"driveType": {
"description": "Drive type (e.g., \"FWD\", \"AWD\")",
"type": "string"
},
"electronicStabilityControl": {
"description": "ESC availability",
"type": "string"
},
"engineCylinders": {
"description": "Number of engine cylinders",
"type": "string"
},
"engineDisplacementL": {
"description": "Engine displacement in liters",
"type": "string"
},
"engineHP": {
"description": "Engine horsepower",
"type": "string"
},
"errorCode": {
"description": "VPIC error code (0 = no error)",
"type": "string"
},
"errorText": {
"description": "VPIC error or warning text",
"type": "string"
},
"fuelType": {
"description": "Primary fuel type",
"type": "string"
},
"make": {
"description": "Vehicle manufacturer when provided by VPIC",
"type": "string"
},
"manufacturer": {
"description": "Full manufacturer name",
"type": "string"
},
"model": {
"description": "Vehicle model when provided by VPIC",
"type": "string"
},
"modelYear": {
"description": "Model year when provided by VPIC",
"type": "string"
},
"plantCity": {
"description": "Manufacturing plant city",
"type": "string"
},
"plantCountry": {
"description": "Manufacturing plant country",
"type": "string"
},
"plantState": {
"description": "Manufacturing plant state",
"type": "string"
},
"tractionControl": {
"description": "Traction control availability",
"type": "string"
},
"trim": {
"description": "Trim level",
"type": "string"
},
"vehicleType": {
"description": "Vehicle type (e.g., \"PASSENGER CAR\")",
"type": "string"
},
"vin": {
"description": "The decoded VIN, echoed back from the request",
"type": "string"
}
},
"required": [
"vin"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Get NCAP crash test ratings and ADAS feature availability for a vehicle. Use when the user specifically wants crash test stars, rollover risk, or wants to compare safety features across vehicles. NCAP data available from 1990+, best coverage for 2011+.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"make": {
"description": "Vehicle manufacturer. Required with model and modelYear when vehicleId is omitted.",
"type": "string"
},
"model": {
"description": "Vehicle model. Required with make and modelYear when vehicleId is omitted.",
"type": "string"
},
"modelYear": {
"description": "Model year, a whole number. Required with make and model when vehicleId is omitted. NCAP coverage increases significantly for 2011+.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"vehicleId": {
"description": "Specific NCAP vehicle ID (from prior results). Skips the year/make/model lookup.",
"type": "number"
}
},
"type": "object"
},
"name": "nhtsa_get_safety_ratings",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"ratings"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `missing_required_combo`: Neither vehicleId nor a complete vehicle triple was supplied. Other values are possible when a failure originates below the handler.",
"examples": [
"missing_required_combo"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when no NCAP ratings are found — e.g. coverage notes or adjacent year suggestion.",
"type": "string"
},
"ratings": {
"description": "Safety ratings per vehicle variant",
"items": {
"additionalProperties": false,
"description": "Safety ratings for a single vehicle variant",
"properties": {
"adasFeatures": {
"additionalProperties": false,
"description": "Advanced driver assistance features",
"properties": {
"electronicStabilityControl": {
"description": "\"Standard\", \"Optional\", or \"Not Available\"",
"type": "string"
},
"forwardCollisionWarning": {
"description": "Forward collision warning availability",
"type": "string"
},
"laneDepartureWarning": {
"description": "Lane departure warning availability",
"type": "string"
}
},
"type": "object"
},
"complaintsCount": {
"description": "Complaints linked by NHTSA to this specific NCAP record. Variant-scoped — for vehicle-level totals call nhtsa_search_complaints.",
"type": "number"
},
"frontalCrash": {
"additionalProperties": false,
"description": "Frontal crash test results",
"properties": {
"driverSide": {
"description": "Driver-side rating",
"type": "string"
},
"overall": {
"description": "Overall frontal crash rating",
"type": "string"
},
"passengerSide": {
"description": "Passenger-side rating",
"type": "string"
}
},
"type": "object"
},
"investigationCount": {
"description": "Investigations linked by NHTSA to this specific NCAP record. Variant-scoped — for vehicle-level totals call nhtsa_search_investigations.",
"type": "number"
},
"overallRating": {
"description": "Overall safety rating (1-5 stars or \"Not Rated\")",
"type": "string"
},
"recallsCount": {
"description": "Recalls linked by NHTSA to this specific NCAP record. Variant-scoped — for vehicle-level totals call nhtsa_search_recalls.",
"type": "number"
},
"rollover": {
"additionalProperties": false,
"description": "Rollover risk assessment",
"properties": {
"dynamicTipResult": {
"description": "Dynamic tip test result",
"type": "string"
},
"probability": {
"description": "Rollover probability (0-1 scale)",
"type": "number"
},
"rating": {
"description": "Rollover resistance rating",
"type": "string"
}
},
"type": "object"
},
"sideCrash": {
"additionalProperties": false,
"description": "Side crash test results",
"properties": {
"barrierOverall": {
"description": "Side barrier overall rating",
"type": "string"
},
"combinedBarrierPoleFront": {
"description": "Combined barrier/pole front rating",
"type": "string"
},
"combinedBarrierPoleRear": {
"description": "Combined barrier/pole rear rating",
"type": "string"
},
"driverSide": {
"description": "Driver-side rating",
"type": "string"
},
"overall": {
"description": "Overall side crash rating",
"type": "string"
},
"passengerSide": {
"description": "Passenger-side rating",
"type": "string"
},
"pole": {
"description": "Side pole crash rating",
"type": "string"
}
},
"type": "object"
},
"vehicleDescription": {
"description": "Vehicle variant description",
"type": "string"
},
"vehicleId": {
"description": "NCAP vehicle ID",
"type": "number"
}
},
"required": [
"vehicleId",
"frontalCrash",
"sideCrash",
"rollover",
"adasFeatures"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Get a comprehensive safety profile for a vehicle. Combines NCAP crash test ratings, recalls, and complaint summary into a single response. Use as the default when asked about vehicle safety, reliability, or purchase decisions.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"make": {
"description": "Vehicle manufacturer (e.g., \"Toyota\", \"Ford\"). Case-insensitive.",
"type": "string"
},
"model": {
"description": "Vehicle model (e.g., \"Camry\", \"F-150\"). Case-insensitive.",
"type": "string"
},
"modelYear": {
"description": "Model year, a whole number (e.g., 2020).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"required": [
"make",
"model",
"modelYear"
],
"type": "object"
},
"name": "nhtsa_get_vehicle_safety",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"sectionStatus",
"warnings",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"complaintSummary": {
"additionalProperties": false,
"description": "Summary of consumer complaints",
"properties": {
"componentBreakdown": {
"description": "Complaints grouped by component",
"items": {
"additionalProperties": false,
"description": "Complaint counts for a single component",
"properties": {
"component": {
"description": "Component name",
"type": "string"
},
"count": {
"description": "Number of complaints",
"type": "number"
},
"crashCount": {
"description": "Complaints involving crashes",
"type": "number"
},
"deathCount": {
"description": "Total deaths reported",
"type": "number"
},
"fireCount": {
"description": "Complaints involving fires",
"type": "number"
},
"injuryCount": {
"description": "Total injuries reported",
"type": "number"
}
},
"required": [
"component",
"count",
"crashCount",
"fireCount",
"injuryCount",
"deathCount"
],
"type": "object"
},
"type": "array"
},
"crashCount": {
"description": "Total complaints involving crashes",
"type": "number"
},
"deathCount": {
"description": "Total deaths across all complaints",
"type": "number"
},
"fireCount": {
"description": "Total complaints involving fires",
"type": "number"
},
"injuryCount": {
"description": "Total injuries across all complaints",
"type": "number"
},
"totalCount": {
"description": "Total complaints filed",
"type": "number"
}
},
"required": [
"totalCount",
"componentBreakdown",
"crashCount",
"fireCount",
"injuryCount",
"deathCount"
],
"type": "object"
},
"effectiveQuery": {
"description": "The vehicle queried, as \"make model modelYear\".",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when no NHTSA records matched the vehicle — e.g. how to verify make/model/year spelling.",
"type": "string"
},
"recalls": {
"description": "All recalls for this vehicle when available",
"items": {
"additionalProperties": false,
"description": "A single recall campaign",
"properties": {
"campaignNumber": {
"description": "NHTSA campaign number",
"type": "string"
},
"component": {
"description": "Affected component",
"type": "string"
},
"consequence": {
"description": "Safety consequence",
"type": "string"
},
"manufacturer": {
"description": "Vehicle/equipment manufacturer",
"type": "string"
},
"overTheAirUpdate": {
"description": "OTA update availability when provided by NHTSA",
"type": "boolean"
},
"parkIt": {
"description": "Do-not-drive advisory when provided by NHTSA",
"type": "boolean"
},
"parkOutSide": {
"description": "Park-outside advisory when provided by NHTSA",
"type": "boolean"
},
"remedy": {
"description": "Corrective action",
"type": "string"
},
"reportReceivedDate": {
"description": "Date recall was reported",
"type": "string"
},
"summary": {
"description": "Recall summary",
"type": "string"
}
},
"required": [
"campaignNumber",
"manufacturer",
"component",
"summary",
"consequence",
"remedy",
"reportReceivedDate"
],
"type": "object"
},
"type": "array"
},
"safetyRatings": {
"description": "Crash test ratings per vehicle variant (e.g., FWD vs AWD)",
"items": {
"additionalProperties": false,
"description": "Safety ratings for a single vehicle variant",
"properties": {
"adasFeatures": {
"additionalProperties": false,
"description": "Advanced driver assistance features",
"properties": {
"electronicStabilityControl": {
"description": "ESC availability",
"type": "string"
},
"forwardCollisionWarning": {
"description": "FCW availability",
"type": "string"
},
"laneDepartureWarning": {
"description": "LDW availability",
"type": "string"
}
},
"type": "object"
},
"frontalCrash": {
"additionalProperties": false,
"description": "Frontal crash test ratings",
"properties": {
"driverSide": {
"description": "Driver-side frontal crash rating",
"type": "string"
},
"overall": {
"description": "Overall frontal crash rating",
"type": "string"
},
"passengerSide": {
"description": "Passenger-side frontal crash rating",
"type": "string"
}
},
"type": "object"
},
"overallRating": {
"description": "Overall safety rating (1-5 stars or \"Not Rated\")",
"type": "string"
},
"rollover": {
"additionalProperties": false,
"description": "Rollover risk assessment",
"properties": {
"dynamicTipResult": {
"description": "Dynamic tip test result",
"type": "string"
},
"probability": {
"description": "Rollover probability (0-1 scale)",
"type": "number"
},
"rating": {
"description": "Rollover resistance rating",
"type": "string"
}
},
"type": "object"
},
"sideCrash": {
"additionalProperties": false,
"description": "Side crash test ratings",
"properties": {
"barrierOverall": {
"description": "Side barrier overall rating",
"type": "string"
},
"combinedBarrierPoleFront": {
"description": "Combined barrier/pole front rating",
"type": "string"
},
"combinedBarrierPoleRear": {
"description": "Combined barrier/pole rear rating",
"type": "string"
},
"driverSide": {
"description": "Driver-side rating",
"type": "string"
},
"overall": {
"description": "Overall side crash rating",
"type": "string"
},
"passengerSide": {
"description": "Passenger-side rating",
"type": "string"
},
"pole": {
"description": "Side pole crash rating",
"type": "string"
}
},
"type": "object"
},
"vehicleDescription": {
"description": "Vehicle variant description",
"type": "string"
},
"vehicleId": {
"description": "NCAP vehicle ID for follow-up queries",
"type": "number"
}
},
"required": [
"vehicleId",
"frontalCrash",
"sideCrash",
"rollover",
"adasFeatures"
],
"type": "object"
},
"type": "array"
},
"sectionStatus": {
"additionalProperties": false,
"description": "Availability of each data section in this response",
"properties": {
"complaints": {
"description": "Availability of complaint data in this response",
"enum": [
"available",
"partial",
"unavailable"
],
"type": "string"
},
"recalls": {
"description": "Availability of recall data in this response",
"enum": [
"available",
"partial",
"unavailable"
],
"type": "string"
},
"safetyRatings": {
"description": "Availability of NCAP safety ratings in this response",
"enum": [
"available",
"partial",
"unavailable"
],
"type": "string"
}
},
"required": [
"safetyRatings",
"recalls",
"complaints"
],
"type": "object"
},
"warnings": {
"description": "Warnings about sections that could not be loaded from NHTSA",
"items": {
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Look up valid makes, models, and vehicle types in NHTSA's database. Use to resolve ambiguous vehicle names, find correct make/model spelling, or discover what models a manufacturer produces.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"description": "Max results in the returned slice. Defaults to 100; max 200.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"make": {
"description": "Make name (required for \"models\" and \"vehicle_types\"). Partial match supported.",
"type": "string"
},
"manufacturer": {
"description": "Manufacturer name or ID (for \"manufacturer\" operation). Partial match supported.",
"type": "string"
},
"modelYear": {
"description": "Filter models to a specific year, a whole number. Only for \"models\" operation.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"offset": {
"description": "Pagination offset into the full result list. Defaults to 0.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"operation": {
"description": "\"makes\" (all NHTSA makes), \"models\" (models for a make), \"vehicle_types\" (types for a make), \"manufacturer\" (manufacturer details).",
"enum": [
"makes",
"models",
"vehicle_types",
"manufacturer"
],
"type": "string"
}
},
"required": [
"operation"
],
"type": "object"
},
"name": "nhtsa_lookup_vehicles",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"operation",
"totalCount",
"returned",
"offset",
"limit",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "Maximum manufacturer records a single lookup retrieves.",
"type": "number"
},
"effectiveQuery": {
"description": "The operation with key args, e.g. \"models make=Toyota year=2020\".",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `missing_operation_arg`: A required argument for the chosen operation was not provided. Other values are possible when a failure originates below the handler.",
"examples": [
"missing_operation_arg"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"limit": {
"description": "Pagination limit used for this response",
"type": "number"
},
"makes": {
"description": "Results for \"makes\" operation",
"items": {
"additionalProperties": false,
"description": "A single make entry",
"properties": {
"makeId": {
"description": "VPIC make ID",
"type": "number"
},
"makeName": {
"description": "Make name",
"type": "string"
}
},
"required": [
"makeId",
"makeName"
],
"type": "object"
},
"type": "array"
},
"manufacturers": {
"description": "Results for \"manufacturer\" operation",
"items": {
"additionalProperties": false,
"description": "A single manufacturer entry",
"properties": {
"country": {
"description": "Country of origin when provided",
"type": "string"
},
"manufacturerId": {
"description": "Manufacturer ID",
"type": "number"
},
"manufacturerName": {
"description": "Manufacturer name",
"type": "string"
},
"vehicleTypes": {
"description": "Vehicle types produced",
"items": {
"additionalProperties": false,
"description": "A single vehicle-type entry produced by this manufacturer",
"properties": {
"id": {
"description": "Vehicle type ID",
"type": "number"
},
"name": {
"description": "Vehicle type name",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"manufacturerId",
"manufacturerName",
"vehicleTypes"
],
"type": "object"
},
"type": "array"
},
"models": {
"description": "Results for \"models\" operation",
"items": {
"additionalProperties": false,
"description": "A single model entry",
"properties": {
"makeId": {
"description": "VPIC make ID",
"type": "number"
},
"makeName": {
"description": "Make name",
"type": "string"
},
"modelId": {
"description": "VPIC model ID",
"type": "number"
},
"modelName": {
"description": "Model name",
"type": "string"
}
},
"required": [
"modelId",
"modelName",
"makeId",
"makeName"
],
"type": "object"
},
"type": "array"
},
"notice": {
"description": "Guidance when the result set is empty or the page is out of bounds.",
"type": "string"
},
"offset": {
"description": "Pagination offset used for this response",
"type": "number"
},
"operation": {
"description": "The operation that was performed",
"type": "string"
},
"returned": {
"description": "Number of results in the returned slice",
"type": "number"
},
"shown": {
"description": "Manufacturer records retrieved before pagination, when the cap was reached.",
"type": "number"
},
"totalCount": {
"description": "Results retrieved before pagination. For \"manufacturer\" this is capped — check the truncated field, since VPIC reports no match total.",
"type": "number"
},
"truncated": {
"description": "True when the \"manufacturer\" lookup stopped at its retrieval cap and further matches may exist upstream.",
"type": "boolean"
},
"vehicleTypes": {
"description": "Results for \"vehicle_types\" operation",
"items": {
"additionalProperties": false,
"description": "A single vehicle-type entry",
"properties": {
"vehicleTypeId": {
"description": "Vehicle type ID",
"type": "number"
},
"vehicleTypeName": {
"description": "Vehicle type name",
"type": "string"
}
},
"required": [
"vehicleTypeId",
"vehicleTypeName"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "Search consumer safety complaints filed with NHTSA for a specific vehicle. Returns a component breakdown over all matching complaints plus a paginated slice of the most recent complaints. Use for common problems, failure patterns, or owner-reported issues.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"component": {
"description": "Filter to a specific component (uppercase, e.g., \"ENGINE\", \"AIR BAGS\", \"ELECTRICAL SYSTEM\"). Matches within comma-separated component lists. Omit to see all.",
"type": "string"
},
"limit": {
"description": "Max complaint narratives to return. Defaults to 20; max 50. componentBreakdown always reflects all matching complaints.",
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"make": {
"description": "Vehicle manufacturer.",
"type": "string"
},
"model": {
"description": "Vehicle model.",
"type": "string"
},
"modelYear": {
"description": "Model year, a whole number.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"offset": {
"description": "Pagination offset into the filing-date-descending complaint list. Defaults to 0. componentBreakdown is unaffected by pagination.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"make",
"model",
"modelYear"
],
"type": "object"
},
"name": "nhtsa_search_complaints",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"totalCount",
"returned",
"offset",
"limit",
"componentBreakdown",
"complaints",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"complaints": {
"description": "Paginated slice of the most recent complaints, date-descending",
"items": {
"additionalProperties": false,
"description": "A single consumer complaint",
"properties": {
"components": {
"description": "Affected components (comma-separated)",
"type": "string"
},
"crash": {
"description": "Involved a crash",
"type": "boolean"
},
"dateComplaintFiled": {
"description": "Date complaint was filed (ISO YYYY-MM-DD)",
"type": "string"
},
"dateOfIncident": {
"description": "Date the incident occurred (ISO YYYY-MM-DD)",
"type": "string"
},
"fire": {
"description": "Involved a fire",
"type": "boolean"
},
"numberOfDeaths": {
"description": "Number of deaths",
"type": "number"
},
"numberOfInjuries": {
"description": "Number of injuries",
"type": "number"
},
"odiNumber": {
"description": "NHTSA complaint ID",
"type": "number"
},
"summary": {
"description": "Consumer-reported description",
"type": "string"
},
"unreliableIncidentDate": {
"additionalProperties": false,
"description": "An incident date NHTSA reported that this complaint's own filing date or model year rules out — report it as contradicted, never as when the incident happened. Appears in place of dateOfIncident, never alongside it; both absent means NHTSA reported no incident date at all.",
"properties": {
"reason": {
"description": "What the reported date contradicts: \"postdates_filing\" — it falls after this complaint was filed; \"predates_model_year\" — it falls before a vehicle of this model year existed.",
"enum": [
"postdates_filing",
"predates_model_year"
],
"type": "string"
},
"reported": {
"description": "The incident date NHTSA reported, ISO YYYY-MM-DD",
"type": "string"
}
},
"required": [
"reported",
"reason"
],
"type": "object"
},
"vin": {
"description": "VIN prefix (partial)",
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"componentBreakdown": {
"description": "Complaints grouped by component, sorted by frequency",
"items": {
"additionalProperties": false,
"description": "Complaint counts for a single component",
"properties": {
"component": {
"description": "Component name",
"type": "string"
},
"count": {
"description": "Number of complaints",
"type": "number"
},
"crashCount": {
"description": "Complaints involving crashes",
"type": "number"
},
"deathCount": {
"description": "Total deaths reported",
"type": "number"
},
"fireCount": {
"description": "Complaints involving fires",
"type": "number"
},
"injuryCount": {
"description": "Total injuries reported",
"type": "number"
}
},
"required": [
"component",
"count",
"crashCount",
"fireCount",
"injuryCount",
"deathCount"
],
"type": "object"
},
"type": "array"
},
"effectiveQuery": {
"description": "\"make model modelYear\" with optional component filter applied, as the server used it.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"limit": {
"description": "Pagination limit used for this page",
"type": "number"
},
"notice": {
"description": "Guidance when no complaints match the vehicle, or when the requested page overshoots the result set.",
"type": "string"
},
"offset": {
"description": "Pagination offset used for this page",
"type": "number"
},
"returned": {
"description": "Number of complaints in this page",
"type": "number"
},
"totalCount": {
"description": "Total complaints matching criteria",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search NHTSA defect investigations from the ODI flat file — covering Preliminary Evaluations (PE), Engineering Analyses (EA), Defect Petitions (DP), Recall Queries (RQ), Audit Queries (AQ), and additional ODI types. make, model, and component are structured filters against the investigation record's vehicle associations. All filters are ANDed. Use nhtsaId to fetch one investigation by its exact ID — including the investigationId nhtsa_search_recalls returns for a campaign. Investigations may link to a resulting recall campaign via recallCampaign.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"component": {
"description": "Structured filter — matches against the investigation's affected components (e.g., \"STEERING\"). ANDed with other filters.",
"type": "string"
},
"investigationType": {
"description": "Filter by ODI investigation type code (the leading letters of the NHTSA ID). Named types: \"PE\" (Preliminary Evaluation), \"EA\" (Engineering Analysis), \"DP\" (Defect Petition), \"RQ\" (Recall Query), \"AQ\" (Audit Query). Additional valid codes present in the dataset: \"SQ\", \"EQ\", \"RP\", \"ID\", \"TA\", \"C\". Pass any code exactly as it appears in the investigation ID prefix.",
"type": "string"
},
"limit": {
"description": "Max investigations to return. Defaults to 20; max 25. The cap is lower than the other paginated tools because a single investigation summary can run several thousand characters and is rendered in full.",
"maximum": 25,
"minimum": 1,
"type": "integer"
},
"make": {
"description": "Structured filter — matches against the investigation's associated vehicle makes (e.g., \"TOYOTA\"). ANDed with other filters.",
"type": "string"
},
"model": {
"description": "Structured filter — matches against the investigation's associated vehicle models. ANDed with other filters.",
"type": "string"
},
"nhtsaId": {
"description": "Exact NHTSA investigation ID (e.g. \"EA23003\"), case-insensitive. Fetches that one record — mutually exclusive with every other filter.",
"type": "string"
},
"offset": {
"description": "Pagination offset into the matching investigations. Defaults to 0.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Free-text search across investigation ID, subject, and summary.",
"type": "string"
},
"status": {
"description": "Filter by status: \"O\" (Open) or \"C\" (Closed). Omit to include both.",
"enum": [
"O",
"C"
],
"type": "string"
}
},
"type": "object"
},
"name": "nhtsa_search_investigations",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"totalCount",
"returned",
"offset",
"limit",
"investigations",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "Applied filters as a readable string, e.g. make=\"Ford\" status=\"O\".",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `mode_conflict`: nhtsaId was combined with another filter. Other values are possible when a failure originates below the handler.",
"examples": [
"mode_conflict"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"investigations": {
"description": "Matching investigations",
"items": {
"additionalProperties": false,
"description": "A single NHTSA investigation",
"properties": {
"closeDate": {
"description": "Date investigation closed (YYYY-MM-DD), if closed",
"type": "string"
},
"components": {
"description": "Affected components",
"items": {
"type": "string"
},
"type": "array"
},
"investigationType": {
"description": "Investigation type code",
"type": "string"
},
"investigationTypeName": {
"description": "Investigation type name",
"type": "string"
},
"makes": {
"description": "Associated vehicle makes",
"items": {
"type": "string"
},
"type": "array"
},
"manufacturer": {
"description": "Manufacturer name",
"type": "string"
},
"models": {
"description": "Associated vehicle models",
"items": {
"type": "string"
},
"type": "array"
},
"nhtsaId": {
"description": "NHTSA investigation ID",
"type": "string"
},
"openDate": {
"description": "Date investigation opened (YYYY-MM-DD)",
"type": "string"
},
"recallCampaign": {
"description": "Linked recall campaign number (if any) — use with nhtsa_search_recalls",
"type": "string"
},
"status": {
"description": "Status code (O=Open, C=Closed)",
"type": "string"
},
"statusName": {
"description": "Status name",
"type": "string"
},
"subject": {
"description": "Investigation subject",
"type": "string"
},
"summary": {
"description": "Investigation summary",
"type": "string"
},
"years": {
"description": "Associated model years",
"items": {
"type": "number"
},
"type": "array"
}
},
"type": "object"
},
"type": "array"
},
"limit": {
"description": "Pagination limit used for this page",
"type": "number"
},
"notice": {
"description": "Guidance when no investigations match the filters, or when the requested page overshoots the result set.",
"type": "string"
},
"offset": {
"description": "Pagination offset used for this page",
"type": "number"
},
"returned": {
"description": "Number of investigations in this page",
"type": "number"
},
"totalCount": {
"description": "Total matching investigations",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search recall campaigns by vehicle or campaign number. Use for specific recall lookups, recall history for a vehicle, or looking up a known campaign number.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"campaignNumber": {
"description": "NHTSA campaign number (e.g., \"20V682000\"). When provided, returns the campaign detail plus every vehicle it covers. Mutually exclusive with make/model/modelYear.",
"type": "string"
},
"dateRange": {
"description": "Filter recalls by received date. Applied locally since the API lacks native date filtering.",
"properties": {
"after": {
"description": "Only recalls received after this date (ISO 8601, e.g., \"2025-01-01\").",
"type": "string"
},
"before": {
"description": "Only recalls received before this date (ISO 8601, e.g., \"2026-01-01\").",
"type": "string"
}
},
"type": "object"
},
"make": {
"description": "Vehicle manufacturer. Required with model and modelYear when not using campaignNumber.",
"type": "string"
},
"model": {
"description": "Vehicle model. Required with make and modelYear.",
"type": "string"
},
"modelYear": {
"description": "Model year, a whole number. Required with make and model.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
}
},
"type": "object"
},
"name": "nhtsa_search_recalls",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"recalls",
"totalCount",
"effectiveQuery"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"effectiveQuery": {
"description": "The search key used: campaign number, or \"make model modelYear\" for vehicle queries.",
"type": "string"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `mode_conflict`: Both campaignNumber and vehicle params were provided. `missing_required_combo`: Neither campaignNumber nor a complete vehicle triple was supplied. `campaign_not_found`: The campaignNumber did not match any NHTSA recall. `invalid_date`: A dateRange bound could not be parsed as a date. Other values are possible when a failure originates below the handler.",
"examples": [
"mode_conflict",
"missing_required_combo",
"campaign_not_found",
"invalid_date"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when no recalls are found — e.g. how to verify make/model/year spelling.",
"type": "string"
},
"recalls": {
"description": "Matching recall campaigns",
"items": {
"additionalProperties": false,
"description": "A single recall campaign",
"properties": {
"affectedVehicles": {
"description": "Every distinct make/model the campaign covers (campaign queries). Equipment and tire campaigns name the part here — make is the brand, model is the part — and carry no model year.",
"items": {
"additionalProperties": false,
"description": "One vehicle covered by the campaign",
"properties": {
"make": {
"description": "Vehicle make",
"type": "string"
},
"model": {
"description": "Vehicle model",
"type": "string"
},
"modelYear": {
"description": "Model year",
"type": "number"
}
},
"type": "object"
},
"type": "array"
},
"campaignNumber": {
"description": "NHTSA campaign number",
"type": "string"
},
"component": {
"description": "Affected component (vehicle-scoped queries)",
"type": "string"
},
"consequence": {
"description": "Safety consequence",
"type": "string"
},
"investigationId": {
"description": "ODI investigation that preceded this campaign, when NHTSA links one (campaign queries) — pass it as nhtsaId to nhtsa_search_investigations for the full record.",
"type": "string"
},
"manufacturer": {
"description": "Vehicle/equipment manufacturer",
"type": "string"
},
"overTheAirUpdate": {
"description": "OTA update availability when provided by NHTSA",
"type": "boolean"
},
"parkIt": {
"description": "Do-not-drive advisory when provided by NHTSA",
"type": "boolean"
},
"parkOutSide": {
"description": "Park-outside advisory when provided by NHTSA",
"type": "boolean"
},
"potentialUnitsAffected": {
"description": "Units affected (campaign queries)",
"type": "number"
},
"remedy": {
"description": "Corrective action",
"type": "string"
},
"reportReceivedDate": {
"description": "Date received by NHTSA (ISO YYYY-MM-DD)",
"type": "string"
},
"summary": {
"description": "Recall summary",
"type": "string"
}
},
"required": [
"campaignNumber",
"manufacturer",
"summary",
"consequence",
"remedy",
"reportReceivedDate"
],
"type": "object"
},
"type": "array"
},
"totalCount": {
"description": "Total recalls matching criteria",
"type": "number"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:e0d7868f9888b6bedc46d1d38a8cd3c0ef798b5bfe1769ea9ccb498c166a9ab6 | sha256sum