plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "cars",
  "version": "1.0.1",
  "description": "Check a US car's public record before you buy or while you own it: decode a VIN, see its recalls, crash test ratings and owner complaints, and compare fuel economy.",
  "author": {
    "name": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
    "email": "support@openkrill.app",
    "url": "https://tools.openkrill.app/"
  },
  "homepage": "https://tools.openkrill.app/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Car Check",
        "shortDescription": "Recalls, ratings and mpg",
        "longDescription": "Check a US car's public record before you buy or while you own it: decode a VIN, see its recalls, crash test ratings and owner complaints, and compare fuel economy.\n\nAsk \"what car is VIN 1HGCM82633A004353?\", \"any recalls on a 2018 Toyota Camry?\", \"give me a report on a 2016 Honda Civic\" or \"what mpg does a 2022 Toyota RAV4 hybrid get?\".\n\nCar Check reads two free official sources: the National Highway Traffic Safety Administration (NHTSA) for VIN decoding, recalls, 5-star crash test ratings and consumer complaints, and the US Environmental Protection Agency's fueleconomy.gov for mpg, mpge, electric range, tailpipe CO2 and estimated annual fuel cost.\n\nThe report answers in one call: the vehicle, its crash ratings, how many recalls NHTSA lists and the newest ones, how many complaints were filed and which components they name most often, and its fuel economy.\n\nComplaints are shown only as a count and the components named. Individual complaint texts and VIN fragments are never returned, and a complaint is a report from an owner, not a confirmed defect.\n\nIt covers vehicles sold in the US. Recalls and complaints are listed by year, make and model, not by VIN, so for one specific car confirm at nhtsa.gov/recalls. A VIN you enter is sent to NHTSA to decode it and is never stored.\n\nCar Check is a data lookup. It is not a valuation, a vehicle history or accident report, an inspection, or safety, mechanical or buying advice.\n\nData from NHTSA (nhtsa.gov) and the US EPA (fueleconomy.gov), which are public US government sources. It stores nothing about you: answers are cached for a day, and the only lasting record is a daily count of calls per tool.",
        "developerName": "HI\u1ebeU V\u0168 TRUNG NGUYEN",
        "category": "Other",
        "capabilities": [
          "Decodes a 17-character VIN into year, make, model, trim, body style, engine and fuel, with NHTSA's own error codes",
          "Lists NHTSA recalls for a year, make and model with the component, consequence and remedy",
          "Shows NHTSA 5-star crash test ratings: overall, front, side and rollover",
          "Counts owner complaints filed with NHTSA and names the components reported most often",
          "Shows EPA fuel economy: city, highway and combined mpg, mpge, electric range and annual fuel cost",
          "Builds a one-call report from a VIN or from year, make and model",
          "Covers US vehicles only and never gives valuation, history or safety advice"
        ],
        "websiteURL": "https://tools.openkrill.app/",
        "privacyPolicyURL": "https://tools.openkrill.app/privacy",
        "termsOfServiceURL": "https://tools.openkrill.app/terms",
        "supportURL": "https://tools.openkrill.app/support",
        "defaultPrompt": [
          "Give me a report on a 2016 Honda Civic",
          "Any recalls on a 2018 Toyota Camry?",
          "What car is VIN 1HGCM82633A004353?"
        ],
        "brandColor": "#C2410C",
        "brandColorDark": "#E0581F",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "demo_recording_url": "https://tools.openkrill.app/demos/cars.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "status ok with the model year, make Honda, model, body class, engine, fuel and plant country, plus NHTSA's error_codes and error_text. Check against: https://vpic.nhtsa.dot.gov/api/vehicles/DecodeVinValues/1HGCM82633A004353?format=json",
              "prompt": "What car is VIN 1HGCM82633A004353?",
              "tools_triggered": "decode_vin",
              "expected_behavior": "Calls decode_vin with vin \"1HGCM82633A004353\"."
            },
            {
              "description": "status ok with crash ratings per variant, a recall count with the newest recalls, a complaint count with the components named most often, and fuel economy, plus the notice that recalls and complaints are by year, make and model and that complaints are not confirmed defects. Check against: https://api.nhtsa.gov/SafetyRatings/modelyear/2016/make/Honda/model/Civic",
              "prompt": "Give me a report on a 2016 Honda Civic.",
              "tools_triggered": "get_vehicle_report",
              "expected_behavior": "Calls get_vehicle_report with year 2016, make \"Honda\" and model \"Civic\"."
            },
            {
              "description": "status ok with the total number of recalls and, newest first, each recall's campaign number, date, component, summary, consequence and remedy, with the reminder that recalls are listed by model, not VIN. Check against: https://api.nhtsa.gov/recalls/recallsByVehicle?make=Toyota&model=Camry&modelYear=2018",
              "prompt": "Any recalls on a 2018 Toyota Camry?",
              "tools_triggered": "list_recalls",
              "expected_behavior": "Calls list_recalls with year 2018, make \"Toyota\" and model \"Camry\"."
            },
            {
              "description": "status ok with the hybrid configurations, each with city, highway and combined mpg, annual fuel cost and tailpipe CO2, labelled as EPA estimates. Check against: https://www.fueleconomy.gov/ws/rest/vehicle/menu/model?year=2022&make=Toyota",
              "prompt": "What mpg does a 2022 Toyota RAV4 hybrid get?",
              "tools_triggered": "get_fuel_economy",
              "expected_behavior": "Calls get_fuel_economy with year 2022, make \"Toyota\", model \"RAV4\" and option \"hybrid\"."
            },
            {
              "description": "status ok with each Model 3 configuration's electric range in miles, mpge and kWh per 100 miles. Check against: https://www.fueleconomy.gov/ws/rest/vehicle/menu/model?year=2020&make=Tesla",
              "prompt": "How many miles of range does a 2020 Tesla Model 3 have?",
              "tools_triggered": "get_fuel_economy",
              "expected_behavior": "Calls get_fuel_economy with year 2020, make \"Tesla\" and model \"Model 3\"."
            }
          ],
          "negative": [
            {
              "description": "The plugin reads recalls, ratings, complaints and fuel economy; it never estimates a vehicle's value. Expected: Does not call a tool. Says Car Check gives no valuations and suggests a pricing guide or dealer.",
              "prompt": "How much is my 2015 Honda Accord worth?"
            },
            {
              "description": "NHTSA and EPA data hold no accident or ownership history, so the plugin cannot answer and must not guess. Expected: May decode the VIN, but says it cannot show accident, ownership or service history and points to a vehicle history report and an inspection.",
              "prompt": "Has this used car ever been in an accident? Here is the VIN."
            },
            {
              "description": "The plugin gives no safety or mechanical advice and a recall list cannot diagnose a specific car. Expected: Does not tell the user whether it is safe. It may offer to list recalls for the model, but says to have a mechanic check the brakes now.",
              "prompt": "My 2012 Ford Focus is pulling to the left when I brake. Is it safe to keep driving?"
            }
          ]
        }
      },
      "publication": {
        "release_notes": "First release. Reads NHTSA and the EPA's fueleconomy.gov: VIN decoding, recalls, crash test ratings, complaint counts and fuel economy. Answers are cached for a day; read-only, no sign-in."
      },
      "apps": "./.app.json"
    }
  }
}