{"openapi":"3.0.3","info":{"title":"Gnist Context — NHTSA Vehicle Safety","description":"NHTSA vehicle safety data — VIN decoding, safety recalls, consumer complaints, and NCAP crash test ratings.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/nhtsa/`\n- **Toolkit page:** `/toolkits/nhtsa`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/nhtsa/decode_vin":{"post":{"tags":["Government"],"summary":"decode_vin","description":"Decode a VIN to get vehicle specifications — make, model, year, engine, drivetrain, and more.\n\nReturns decoded vehicle details from the NHTSA Vehicle Product Information Catalog (vPIC).\nSupports all standard 17-character VINs for vehicles sold in the US and Canada.","operationId":"nhtsa_decode_vin","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"vin":{"description":"17-character Vehicle Identification Number (e.g. \"1HGCM82633A004352\").","type":"string"}},"required":["vin"],"type":"object"}}}}}},"/rest/nhtsa/get_recalls":{"post":{"tags":["Government"],"summary":"get_recalls","description":"Get safety recalls for a specific vehicle make, model, and year.\n\nReturns recall campaigns with component affected, summary, consequence,\nremedy, and NHTSA campaign numbers. Covers all federally mandated recalls.","operationId":"nhtsa_get_recalls","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"make":{"description":"Vehicle manufacturer (e.g. \"Honda\", \"Toyota\", \"Ford\").","type":"string"},"model":{"description":"Vehicle model name (e.g. \"Accord\", \"Camry\", \"F-150\").","type":"string"},"model_year":{"description":"4-digit model year (e.g. \"2020\").","type":"string"}},"required":["make","model","model_year"],"type":"object"}}}}}},"/rest/nhtsa/get_complaints":{"post":{"tags":["Government"],"summary":"get_complaints","description":"Get consumer complaints filed with NHTSA for a specific vehicle.\n\nReturns complaints with crash/fire indicators, injury/death counts,\naffected components, incident summaries, and dates. Useful for\nidentifying common issues with a vehicle.","operationId":"nhtsa_get_complaints","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"make":{"description":"Vehicle manufacturer (e.g. \"Honda\", \"Toyota\", \"Ford\").","type":"string"},"model":{"description":"Vehicle model name (e.g. \"Accord\", \"Camry\", \"F-150\").","type":"string"},"model_year":{"description":"4-digit model year (e.g. \"2020\").","type":"string"},"limit":{"default":20,"description":"Max complaints to return (1-100). Default 20.","type":"integer"}},"required":["make","model","model_year"],"type":"object"}}}}}},"/rest/nhtsa/get_safety_ratings":{"post":{"tags":["Government"],"summary":"get_safety_ratings","description":"Get NHTSA crash test safety ratings (NCAP 5-star system).\n\nReturns overall, frontal crash, side crash, and rollover ratings.\nAlso includes complaint, recall, and investigation counts per vehicle variant.","operationId":"nhtsa_get_safety_ratings","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"make":{"description":"Vehicle manufacturer (e.g. \"Honda\", \"Toyota\", \"Ford\").","type":"string"},"model":{"description":"Vehicle model name (e.g. \"Accord\", \"Camry\", \"F-150\").","type":"string"},"model_year":{"description":"4-digit model year (e.g. \"2020\").","type":"string"}},"required":["make","model","model_year"],"type":"object"}}}}}},"/rest/nhtsa/search_makes":{"post":{"tags":["Government"],"summary":"search_makes","description":"List all vehicle makes with safety rating data for a given model year.\n\nUseful to discover which manufacturers and brands are available before\nquerying specific models. Returns make names and IDs.","operationId":"nhtsa_search_makes","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"model_year":{"description":"4-digit model year to list makes for (e.g. \"2024\").","type":"string"}},"required":["model_year"],"type":"object"}}}}}},"/rest/nhtsa/report_feedback":{"post":{"tags":["Government"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"nhtsa_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Government","description":"Data sources: Government"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}