plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "licenseclear",
  "version": "1.0.0",
  "description": "Check a Florida or California contractor's license from official state records: status, expiry, trade, workers' comp, bond and Florida discipline cases, or find licensed contractors by trade and county.",
  "author": {
    "name": "LicenseClear",
    "url": "https://licenseclear.brightpathfund.io"
  },
  "homepage": "https://licenseclear.brightpathfund.io",
  "keywords": [
    "contractor",
    "license",
    "Florida",
    "California",
    "home improvement"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "LicenseClear",
        "shortDescription": "Check contractor licenses",
        "longDescription": "LicenseClear is a contractor license lookup tool: its one purpose is to help you verify a contractor before hiring. It looks up contractors in official Florida (DBPR) and California (CSLB) public licensing records. Give it a license number or business name to see license status, expiry date, trade, workers' comp and bond where the state publishes them, and Florida discipline cases. Or ask it to list active licensed contractors for a trade in a Florida or California county, filtered to licenses with no Florida discipline on record or California workers' comp on file. Intended for homeowners and anyone vetting a contractor before hiring. Limitations: only Florida and California are covered; California discipline is not in the state's downloadable data, so a link to the official CSLB record is given instead; results are public records as of the stated data date, not a recommendation or quality ranking, and should be verified with the state licensing board before hiring.",
        "developerName": "LicenseClear",
        "category": "Other",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://licenseclear.brightpathfund.io",
        "supportURL": "https://licenseclear.brightpathfund.io/support",
        "privacyPolicyURL": "https://licenseclear.brightpathfund.io/privacy",
        "termsOfServiceURL": "https://licenseclear.brightpathfund.io/terms",
        "defaultPrompt": [
          "Is California contractor license 1000002 valid?",
          "Find roofers in Orange County, Florida with no discipline.",
          "Look up Smith Roofing in San Diego."
        ],
        "brandColor": "#0B5563",
        "composerIcon": "./assets/icon.svg",
        "logo": "./assets/icon.svg"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Look up a California license by number",
              "prompt": "Is California contractor license 1000002 valid?",
              "tools_triggered": "get_contractor_record",
              "expected_behavior": "Returns the record for license 1000002 (Well Drilling, Lodi): status, issue and expiry dates, workers' comp and bond, a link to the official CSLB page, and the data as-of date."
            },
            {
              "description": "Look up a Florida license by number",
              "prompt": "Check Florida contractor license CGC1522444.",
              "tools_triggered": "get_contractor_record",
              "expected_behavior": "Returns the Florida DBPR record for CGC1522444 with status, expiry, trade, any discipline cases, source and data as-of date."
            },
            {
              "description": "Look up a contractor by business name",
              "prompt": "Look up Smith Roofing in San Diego, California.",
              "tools_triggered": "get_contractor_record",
              "expected_behavior": "Returns a matching record, or a short list of candidate licenses and asks which one is meant if the name fits several."
            },
            {
              "description": "Find licensed contractors by trade and county (Florida, no discipline)",
              "prompt": "Find roofers in Orange County, Florida with no discipline on record.",
              "tools_triggered": "find_licensed_contractors",
              "expected_behavior": "Returns up to 10 active Florida roofing licenses in Orange County with no discipline found, sorted by longest time licensed, with source and data as-of date."
            },
            {
              "description": "Find licensed contractors with workers' comp (California)",
              "prompt": "Find plumbers in San Diego County, California that have workers' comp on file.",
              "tools_triggered": "find_licensed_contractors",
              "expected_behavior": "Returns active California plumbing licenses in San Diego County with workers' comp on file, sorted by longest time licensed, with source and data as-of date."
            }
          ],
          "negative": [
            {
              "description": "State not covered",
              "prompt": "Is Texas contractor license TX12345 valid?"
            },
            {
              "description": "Request for a quality recommendation",
              "prompt": "Which roofer in Miami is the best and has the happiest customers?"
            },
            {
              "description": "Unrelated request",
              "prompt": "Write me a poem about the ocean."
            }
          ]
        }
      },
      "apps": "./.app.json"
    }
  }
}