@pipeworx/mcp-nhtsa 0.2.2 → 0.3.0

package/tools.json

@@ -0,0 +1,222 @@
+[
+  {
+    "name": "decode_vin",
+    "description": "Decode a VIN to get vehicle details. Returns make, model, year, body style, engine type, drivetrain, and plant. E.g., '1HGBH41JXMN109186'. (For recalls/ratings use get_recalls / get_safety_ratings.)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "vin": {
+          "type": "string",
+          "description": "17-character VIN (e.g., \"1HGBH41JXMN109186\")"
+        }
+      },
+      "required": [
+        "vin"
+      ]
+    }
+  },
+  {
+    "name": "get_makes",
+    "description": "Get all vehicle brands for a model year. Returns make names and IDs. E.g., year '2023'.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  {
+    "name": "get_models",
+    "description": "Get all vehicle models for a make and year. Returns model names and IDs. E.g., make 'Toyota', year '2023'.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "make": {
+          "type": "string",
+          "description": "Vehicle make name (e.g., \"Toyota\", \"Ford\", \"BMW\")"
+        },
+        "year": {
+          "type": "number",
+          "description": "Model year (e.g., 2022)"
+        }
+      },
+      "required": [
+        "make",
+        "year"
+      ]
+    }
+  },
+  {
+    "name": "get_recalls",
+    "description": "Get official NHTSA safety RECALLS for a vehicle. PREFER OVER WEB SEARCH for \"is my car recalled\", \"recalls on a 2021 Honda Civic\", \"open recalls for make/model/year\". Returns each recall: component, summary, safety consequence, remedy, NHTSA campaign number, and report date. Pass make + model + model_year.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "make": {
+          "type": "string",
+          "description": "Vehicle make (e.g., \"Honda\")"
+        },
+        "model": {
+          "type": "string",
+          "description": "Vehicle model (e.g., \"Civic\")"
+        },
+        "model_year": {
+          "type": "number",
+          "description": "Model year (e.g., 2021)"
+        }
+      },
+      "required": [
+        "make",
+        "model",
+        "model_year"
+      ]
+    }
+  },
+  {
+    "name": "get_complaints",
+    "description": "Get owner-filed NHTSA complaints for a vehicle — real-world problems drivers reported (vs official recalls). Use for \"common problems with a 2020 Ford Explorer\", \"what are owners complaining about\". Returns components, summary, crash/fire flags, injuries/deaths, and filing date. Pass make + model + model_year.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "make": {
+          "type": "string",
+          "description": "Vehicle make (e.g., \"Ford\")"
+        },
+        "model": {
+          "type": "string",
+          "description": "Vehicle model (e.g., \"Explorer\")"
+        },
+        "model_year": {
+          "type": "number",
+          "description": "Model year (e.g., 2020)"
+        }
+      },
+      "required": [
+        "make",
+        "model",
+        "model_year"
+      ]
+    }
+  },
+  {
+    "name": "get_safety_ratings",
+    "description": "Get NHTSA 5-Star Safety Ratings (NCAP crash-test results) for a vehicle — overall, frontal, side, and rollover star ratings. Use for \"crash test rating for a 2021 Honda Civic\", \"how safe is X\". Pass make + model + model_year.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "make": {
+          "type": "string",
+          "description": "Vehicle make (e.g., \"Honda\")"
+        },
+        "model": {
+          "type": "string",
+          "description": "Vehicle model (e.g., \"Civic\")"
+        },
+        "model_year": {
+          "type": "number",
+          "description": "Model year (e.g., 2021)"
+        }
+      },
+      "required": [
+        "make",
+        "model",
+        "model_year"
+      ]
+    }
+  },
+  {
+    "name": "fars_state_fatalities",
+    "description": "Fatal motor-vehicle crash counts and fatalities for a US state, from NHTSA's Fatality Analysis Reporting System (FARS). Pass a state (full name like \"Texas\", 2-letter postal code like \"TX\", or FIPS code) and a year. Returns monthly rows: crashes, fatalities, persons involved, vehicles involved, pedestrians involved. Omit year to get every loaded year/month for that state. Covers a recent multi-year window (see data_as_of and call fars_coverage for the exact range), not full FARS history. Unknown states are refused with a clear error, never an empty success.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "state": {
+          "type": "string",
+          "description": "State name (\"Texas\"), 2-letter postal code (\"TX\"), or FIPS code (\"48\")."
+        },
+        "year": {
+          "type": "number",
+          "description": "Optional: calendar year, e.g. 2023. Omit to return every loaded year for this state."
+        }
+      },
+      "required": [
+        "state"
+      ]
+    }
+  },
+  {
+    "name": "fars_vehicle_makes",
+    "description": "Vehicle makes involved in fatal crashes nationwide for a given year, from NHTSA FARS. Pass year alone to get the top makes ranked by vehicle-involvement count (e.g. \"which vehicle makes show up most in fatal crashes in 2023\"); pass make as well to get that one make's involvement count across every loaded year. This is an INVOLVEMENT count, not a claim that the make caused the crash. Unknown makes are refused with a clear error naming a few valid makes, never an empty success.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "year": {
+          "type": "number",
+          "description": "Calendar year, e.g. 2023. Required unless make is given (then optional, scoping to one year)."
+        },
+        "make": {
+          "type": "string",
+          "description": "Optional: vehicle make, e.g. \"Toyota\", \"Ford\", \"Harley-Davidson\"."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max makes to return when ranking by year. Default 20, max 50."
+        }
+      },
+      "required": []
+    }
+  },
+  {
+    "name": "fars_coverage",
+    "description": "What FARS fatal-crash data this pack actually has loaded right now: the earliest and latest year covered and when it was last loaded. Call this before fars_state_fatalities/fars_vehicle_makes if unsure a given year is covered.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {}
+    }
+  },
+  {
+    "name": "fuel_economy_mpg",
+    "description": "EPA fuel-economy ratings (city/highway/combined MPG, CO2 g/mile, fuel type) for a specific model year + make + model, from fueleconomy.gov (DOE/EPA), proxied live. Pass the model string exactly as fueleconomy.gov lists it (e.g. \"Camry\", \"F-150 2WD\", \"Model 3\") -- if unsure, call fuel_economy_models first to see valid model strings for that year+make. A model year/make/model can have several engine/transmission/drivetrain VARIANTS; this returns up to 5, each with its own MPG. Unknown make/model/year combos are refused with a clear error (never an empty success) and, when the make or model itself is not recognized for that year, list a few valid options.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "year": {
+          "type": "number",
+          "description": "Model year, e.g. 2024."
+        },
+        "make": {
+          "type": "string",
+          "description": "Vehicle make, e.g. \"Toyota\"."
+        },
+        "model": {
+          "type": "string",
+          "description": "Vehicle model exactly as fueleconomy.gov lists it, e.g. \"Camry\". Call fuel_economy_models to see valid strings."
+        }
+      },
+      "required": [
+        "year",
+        "make",
+        "model"
+      ]
+    }
+  },
+  {
+    "name": "fuel_economy_models",
+    "description": "List the exact model strings fueleconomy.gov recognizes for a given model year + make (e.g. year 2024, make \"Toyota\" -> \"Camry\", \"Camry Hybrid LE\", \"RAV4 AWD\", ...). Call this before fuel_economy_mpg when you are not sure of the exact model string, or when fuel_economy_mpg refuses a model as unrecognized.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "year": {
+          "type": "number",
+          "description": "Model year, e.g. 2024."
+        },
+        "make": {
+          "type": "string",
+          "description": "Vehicle make, e.g. \"Toyota\"."
+        }
+      },
+      "required": [
+        "year",
+        "make"
+      ]
+    }
+  }
+]