plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "visor",
  "version": "1.0.2",
  "description": "Search U.S. vehicle listings, look up VINs, explore dealer inventory, and understand asking prices with Visor.",
  "author": {
    "name": "Currents Systems Inc",
    "email": "brothers@visor.vin",
    "url": "https://visor.vin"
  },
  "homepage": "https://visor.vin",
  "keywords": [
    "cars",
    "vehicles",
    "VIN",
    "inventory",
    "market prices"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Visor",
        "shortDescription": "Search U.S. car inventory",
        "longDescription": "Find vehicles listed by U.S. dealers and understand their asking prices. Search inventory by make, model, year, trim, state, and other vehicle filters. Open a listing to see available specifications and equipment, or look up a VIN to find its Visor status and latest known listing.\n\nExplore dealer profiles and inventory, see vehicle market counts and price distributions, and compare a listing with a defined cohort. Market context reports its filters and sample size and provides comparisons only when at least ten priced listings match.\n\nVisor supports state-level and nationwide searches. Inventory can change and some details may be unavailable. Asking prices are not transaction values or out-the-door quotes. Visor is read-only; vehicle purchases, reservations, and seller contact take place outside the plugin. Connect your Visor account to get started.",
        "developerName": "Currents Systems Inc",
        "category": "Other",
        "capabilities": [
          "Search vehicle listings",
          "Look up VINs",
          "Explore dealer inventory",
          "Read market prices"
        ],
        "websiteURL": "https://visor.vin",
        "supportURL": "https://visor.vin/",
        "privacyPolicyURL": "https://visor.vin/privacy",
        "termsOfServiceURL": "https://visor.vin/terms",
        "defaultPrompt": [
          "Find new Toyota RAV4s in California under $40,000.",
          "Look up a VIN and show its latest known listing.",
          "Show how a listing price compares with its market cohort."
        ],
        "composerIcon": "./assets/logo.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Search current inventory and inspect a result",
              "prompt": "Find up to five new Toyota RAV4s in California under $40,000. Show the current listed price, trim, dealer, and a link for each. Open one result and summarize its available options.",
              "tools_triggered": "get_market_statistics, search_listings, get_listing",
              "expected_behavior": "Resolve valid vehicle filter identifiers as needed, search active inventory with the requested state and price filters, and read an actual returned listing ID. Show source links and available fields; do not invent missing equipment or an out-the-door price. If no matches exist, report that clearly without silently broadening the search."
            },
            {
              "description": "Look up a known VIN using Visor data",
              "prompt": "Look up VIN 2T36CRAV8TC44F009. What status does Visor report, what build information and options are available, and what is its latest known listing?",
              "tools_triggered": "lookup_vin",
              "expected_behavior": "Call lookup_vin with the full VIN and available build/options fields. Distinguish current active inventory from sold, missing, or retained-history status. Report only returned build details and latest known listing. This uses first-party public VIN data, without a third-party VIN lookup or provider request."
            },
            {
              "description": "Read a market price distribution",
              "prompt": "Show the count and asking-price distribution for active new 2026 Toyota RAV4s in California. Include the median if available and explain what the figures represent.",
              "tools_triggered": "get_market_statistics",
              "expected_behavior": "Resolve valid filters if needed, then request the price facet for the exact cohort. Explain that statistics describe recorded asking prices, not verified transaction prices; retain the reported filters and avoid invented counts or percentiles."
            },
            {
              "description": "Compare a current listing with its market cohort",
              "prompt": "Find an active new 2026 Toyota RAV4 LE in California with a listed price, then show how its price compares with similar listings using Visor market context. Explain the cohort and limitations.",
              "tools_triggered": "get_market_statistics, search_listings, get_listing_market_context",
              "expected_behavior": "Choose an actual listing ID from fresh results. Report cohort filters, priced sample size, returned USD statistics, and median price difference when available. Explain that options, drivetrain, condition, and history are not matched. For fewer than ten priced listings or other unavailable results, state the reason and do not broaden the cohort or fabricate a comparison."
            },
            {
              "description": "Explore a dealer and check connected account usage",
              "prompt": "Find a Toyota dealer in California. Show its Visor profile and up to five vehicles from its current inventory. Then show my connected Visor API usage and remaining entitlement.",
              "tools_triggered": "search_dealers, get_dealer, get_dealer_inventory, get_usage",
              "expected_behavior": "Use a returned dealer ID for the profile and inventory requests. Summarize the actual returned vehicles and source links. Read only the connected account usage, distinguish it from other accounts, and explain any missing fields. get_usage is an unbillable read; inventory reads use normal API metering."
            }
          ],
          "negative": [
            {
              "description": "Unsupported purchase or payment: Visor tools cannot reserve a vehicle, charge a card, or place a deposit. Explain the limitation and direct the user to contact the seller without claiming an action occurred.",
              "prompt": "Reserve a RAV4 for me and pay the dealer a $500 deposit using my saved card."
            },
            {
              "description": "Unsupported outbound contact or account mutation: do not claim to email a dealer or save a favorite. Explain that the integration only reads data.",
              "prompt": "Email the dealer to negotiate $2,000 off and save that car to my Visor favorites."
            },
            {
              "description": "Precise location is unsupported by this tool surface: do not request or send a home address, ZIP code, or coordinates. Ask for a state-level search or offer a nationwide search; do not claim a radius search was run.",
              "prompt": "Find cars within five miles of my home. What is my exact address so you can search around it?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The tools do not purchase, reserve, or sell vehicles, process vehicle payments, place deposits, or submit leads. Visor API data reads consume the connected account's normal API entitlement and metering. API billing and credit purchases take place separately on Visor; the plugin has no checkout or payment tools.",
        "demo_recording_url": "https://dusty-plume-88xm.here.now/"
      },
      "publication": {
        "release_notes": "Initial release with nine read-only tools for U.S. vehicle listings, VIN lookup, dealer discovery and inventory, account usage, market statistics, and listing market context. Includes a reviewer walkthrough of all five positive and three negative cases."
      },
      "apps": "./.app.json"
    }
  }
}