plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "bumper-vehicle-history",
  "version": "1.0.3",
  "description": "Bumper creates vehicle history reports from a VIN, license plate and state, or year, make, model, and trim, then helps users review the records available for ownership, title history, accidents, recalls, market value, specifications, safety ratings, and warranty information.",
  "author": {
    "name": "The Lifetime Value Co."
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Bumper",
        "shortDescription": "Vehicle history reports",
        "longDescription": "Bumper helps users create vehicle history reports from a VIN, license plate and US state, or year, make, model, and trim. Users can review the vehicle records available to Bumper, including ownership and title history, liens, inspections, sales, accidents, recalls, reported damage, market-value estimates, specifications, equipment, safety ratings, complaints, and warranty information. Data availability varies by vehicle and source. A missing record does not prove that an event never occurred, and pricing or ownership-cost figures are estimates rather than guaranteed prices. Creating a report consumes an available Bumper vehicle-report credit or entitlement.",
        "developerName": "The Lifetime Value Co.",
        "category": "Other",
        "defaultPrompt": [
          "What should I know about this car before buying? JTDKTUD30ED581625",
          "Does this car have any accidents or damage? JTDKTUD30ED581625",
          "What options and packages are installed on this vehicle? JTDKTUD30ED581625"
        ],
        "websiteURL": "https://www.bumper.com/",
        "supportURL": "https://support.bumper.com/",
        "privacyPolicyURL": "https://www.bumper.com/privacy-policy/",
        "termsOfServiceURL": "https://www.bumper.com/terms/",
        "logo": "./assets/bumper-icon.png",
        "composerIcon": "./assets/bumper-icon.png",
        "brandColor": "#FF4722",
        "brandColorDark": "#8736C1"
      },
      "review": {
        "commerce": true,
        "commerce_description": "Bumper does not process payments inside ChatGPT. Users purchase a Bumper membership or vehicle-report credits on Bumper.com, and each report created through the plugin consumes an available vehicle-report credit or entitlement.",
        "demo_recording_url": "https://jam.dev/c/d2ab95c6-db86-4a78-a6bf-b025aa7fd984",
        "test_cases": {
          "positive": [
            {
              "description": "Create a vehicle-history report from a confirmed VIN for a 2014 Toyota Yaris. The reference report was updated on 2026-10-06 and identified the vehicle as a 2014 Toyota Yaris with estimated mileage and market-value data. Those live estimates may change, so the test checks identity and response structure rather than freezing the numeric values.",
              "prompt": "What should I know about this 2014 Toyota Yaris before buying it? VIN JTDKTUD30ED581625",
              "tools_triggered": "create_vehicle_report_by_vin_v2",
              "expected_behavior": "Call create_vehicle_report_by_vin_v2 once with vin set to JTDKTUD30ED581625. Return a report_id and available vehicle overview and history sections identifying a 2014 Toyota Yaris. Present mileage and market-value figures as current estimates from the tool response, not guaranteed values, and do not describe Bumper data as exhaustive."
            },
            {
              "description": "Create a vehicle-history report from a confirmed New Jersey license plate. The reference report was updated on 2026-10-06 and identified a 2017 Land Rover Range Rover Evoque SE / SE Premium, with one damage record, one owner in five years, no open recalls, and market-value data. Live values may change.",
              "prompt": "Create a vehicle history report for New Jersey license plate E21HNB and summarize the important findings.",
              "tools_triggered": "create_vehicle_report_by_plate_v2",
              "expected_behavior": "Call create_vehicle_report_by_plate_v2 once with license_plate set to E21HNB and state set to NJ. Return a report_id and the available report sections identifying a 2017 Land Rover Range Rover Evoque SE / SE Premium. Summarize only records returned by the tool, treat prices and mileage as estimates, and avoid claiming the history is complete."
            },
            {
              "description": "Boundary case using an existing Toyota report whose reference result showed no damage records and no open recalls. Setup: the conversation already contains a valid report_id returned for VIN JTDKTUD30ED581625 by the same reviewer account.",
              "prompt": "Using the Toyota Yaris report you just created, show me its accident, damage, salvage, recall, repair, and maintenance records.",
              "tools_triggered": "get_vehicle_damages",
              "expected_behavior": "Call get_vehicle_damages with the Toyota report_id already present in the conversation. Accurately summarize the returned sections. If the tool returns no damage or recall records, say that none were found in the available Bumper data; do not claim that no damage ever occurred or that the vehicle has a guaranteed clean history."
            },
            {
              "description": "Retrieve focused ownership and title information from the confirmed Land Rover report. Setup: the conversation already contains a valid report_id returned for plate E21HNB in NJ by the same reviewer account.",
              "prompt": "Using the Land Rover report you just created, show me the ownership, title, lien, inspection, and sales history.",
              "tools_triggered": "get_vehicle_background",
              "expected_behavior": "Call get_vehicle_background with the Land Rover report_id already present in the conversation. Summarize the returned ownership, title, lien, inspection, sales, and investigation records. The reference result showed one owner in five years, but the answer must follow the current tool response and must not turn record counts into stronger real-world conclusions."
            },
            {
              "description": "Retrieve equipment and technical specifications from the existing Toyota report. Setup: the conversation already contains a valid report_id returned for VIN JTDKTUD30ED581625 by the same reviewer account.",
              "prompt": "Using the Toyota Yaris report you just created, list its reported specifications, equipment, options, and packages.",
              "tools_triggered": "get_vehicle_specs",
              "expected_behavior": "Call get_vehicle_specs with the Toyota report_id already present in the conversation. Summarize only the specifications and equipment returned by the tool, and explain that reported equipment may not include every factory-installed option."
            }
          ],
          "negative": [
            {
              "description": "Bumper cannot purchase vehicles or charge payment cards. Explain that limitation and do not invoke any Bumper tool.",
              "prompt": "Buy this Toyota Yaris for me and charge my card."
            },
            {
              "description": "Bumper cannot schedule repair appointments. Explain that limitation and do not invoke any Bumper tool.",
              "prompt": "Schedule a brake repair appointment for the Land Rover tomorrow."
            },
            {
              "description": "Bumper does not generate or bind auto-insurance quotes. Explain that limitation and do not invoke any Bumper tool.",
              "prompt": "Get me an auto insurance quote for VIN JTDKTUD30ED581625."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Updated the Bumper listing and composer icon to the current B brand artwork and applied the official orange and purple theme colors while retaining the verified OAuth-connected vehicle-report integration and review materials.",
        "countries": []
      },
      "apps": "./.app.json"
    }
  }
}