plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "solarscope",
  "version": "1.0.0",
  "description": "Screen US sites for solar resource, grid distance and FEMA flood risk; save sites and create PDF site reports.",
  "author": {
    "name": "Lissjos Engineering LLC",
    "email": "support@solarscope.io",
    "url": "https://solarscope.io"
  },
  "homepage": "https://solarscope.io/ai-agents",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SolarScope",
        "shortDescription": "Screen US sites for solar",
        "longDescription": "SolarScope screens locations in the United States for solar development. Ask about a site by its coordinates and get its solar resource (NREL), the distance and voltage of the nearest transmission line (HIFLD), and whether it lies in a FEMA high-risk flood zone, together with a clear verdict: no deal-breakers, things to check, or a possible deal-breaker.\n\nScreen up to 25 sites at once and get them ranked best first, save the most promising ones to your SolarScope projects, read the projects you already saved, and create a PDF site report you can share.\n\nSolarScope uses the same public data and the same rules as the SolarScope website, so results match what you see in Site Studio. It is a first screen to decide which sites deserve a closer look, not a substitute for a utility interconnection study or a flood survey.\n\nSign in with your SolarScope account to connect. ChatGPT only sees the projects in your own account, and you can disconnect at any time from your SolarScope account page.",
        "developerName": "Lissjos Engineering LLC",
        "category": "Data & Analytics",
        "capabilities": [
          "Screen a US site for solar resource, grid distance and FEMA flood risk",
          "Screen and rank up to 25 sites, best first",
          "Save sites to your SolarScope projects",
          "Read your saved SolarScope projects",
          "Create PDF site reports"
        ],
        "websiteURL": "https://solarscope.io",
        "supportURL": "https://solarscope.io/contact",
        "privacyPolicyURL": "https://solarscope.io/privacy",
        "termsOfServiceURL": "https://solarscope.io/terms",
        "defaultPrompt": [
          "Screen 33.351, -112.75 near Buckeye, Arizona for a solar farm",
          "Which of my saved SolarScope sites have possible deal-breakers?",
          "Make a one-page PDF report for my best saved site"
        ],
        "brandColor": "#E8573A",
        "brandColorDark": "#FF6B4A",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Screen one site by coordinates",
              "prompt": "Screen 33.351, -112.75 near Buckeye, Arizona for a utility-scale solar farm.",
              "tools_triggered": "screen_site",
              "expected_behavior": "Calls screen_site once and reports solar resource about 5.8 kWh/m2/day (GHI), the nearest transmission line about 1.5 km away (238 kV, Arizona Public Service, in service), the site outside FEMA high-risk flood zones, and the verdict 'No deal-breakers found'."
            },
            {
              "description": "Screen and rank several sites",
              "prompt": "Rank these sites for solar: Pahrump NV (36.2, -116.0), Miami FL (25.76, -80.19) and Pecos County TX (31.05, -102.9).",
              "tools_triggered": "screen_sites",
              "expected_behavior": "Calls screen_sites once with the three sites and returns them ranked: Pahrump first, Pecos County second, Miami last because it lies inside FEMA high-risk flood zone AE (possible deal-breaker)."
            },
            {
              "description": "Find deal-breakers among saved projects",
              "prompt": "Which of my saved SolarScope sites have possible deal-breakers?",
              "tools_triggered": "list_projects",
              "expected_behavior": "Calls list_projects and names Miami Gardens, FL as the saved site with a possible deal-breaker (FEMA high-risk flood zone), and lists the others with their verdicts. No usage is counted."
            },
            {
              "description": "Read one saved project",
              "prompt": "Show me the details and notes of my Pecos County, TX project.",
              "tools_triggered": "list_projects, get_project",
              "expected_behavior": "Finds the Pecos County, TX project with list_projects, then calls get_project and shows its solar, grid and flood details, its verdict and the note 'ERCOT West; very close to a 138 kV line.'"
            },
            {
              "description": "Save a new site and create a PDF report",
              "prompt": "Save a new site called Mojave Test at 35.05, -118.17 and create a one-page PDF report for it.",
              "tools_triggered": "save_site, create_report",
              "expected_behavior": "Calls save_site (screens the location and saves it as a new project, returning a link to open it in SolarScope), then create_report with the new project id and the summary preset, and returns a working PDF download link valid for 7 days."
            }
          ],
          "negative": [
            {
              "description": "Deleting projects is not supported",
              "prompt": "Delete all of my SolarScope projects.",
              "expected_behavior": "No tool is called. ChatGPT explains that SolarScope cannot delete projects from ChatGPT and that projects can be managed on solarscope.io."
            },
            {
              "description": "Unrelated request must not trigger SolarScope",
              "prompt": "What will the weather be like in Phoenix tomorrow?",
              "expected_behavior": "No SolarScope tool is called; the question is unrelated to solar site screening."
            },
            {
              "description": "Invalid coordinates are rejected with a clear message",
              "prompt": "Screen the site at latitude 123, longitude 500 for solar.",
              "expected_behavior": "screen_site returns the error 'lat and lng must be valid coordinates: latitude between -90 and 90, longitude between -180 and 180.' and ChatGPT asks the user for valid coordinates instead of guessing."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/PJEkFCZD7KE",
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments."
      },
      "publication": {
        "countries": [],
        "release_notes": "First release: screen and rank US solar sites (solar resource, transmission distance, FEMA flood zones), save sites to SolarScope projects, read saved projects and create PDF site reports."
      },
      "apps": "./.app.json"
    }
  }
}