plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "sunset-score",
  "version": "1.0.1",
  "description": "Forecast sunrise and sunset visual quality for a chosen destination or your client-shared approximate location.",
  "author": {
    "name": "CHRISTMAS SERVICES S.R.L.",
    "email": "info@sunset-score.com",
    "url": "https://sunset-score.com"
  },
  "homepage": "https://sunset-score.com/api/",
  "keywords": [
    "sunrise",
    "sunset",
    "photography",
    "forecast",
    "sky"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Sunset Score",
        "shortDescription": "Plan sunrise and sunset shoots",
        "longDescription": "Plan sunrise and sunset photography with visual quality forecasts from Sunset Score. Choose a destination such as Chicago, provide coordinates, or ask about the approximate location shared by your client. Get 0\u2013100 beauty scores, event times and descriptive labels for up to three local calendar days, then compare the returned events. Scores estimate visual quality; they are not probabilities or guarantees.\n\nFor a named destination, the assistant resolves approximate city-center or public-place coordinates before calling the forecast tool; Sunset Score does not geocode place names. Ambiguous destinations need clarification. Near-me forecasts use client-shared approximate location and are unavailable without it; destination forecasts do not require device location. The plugin does not ask for a home address, precise device GPS, an account or payment details. It cannot retrieve historical forecasts, create alerts or manage subscriptions. Polar conditions and unavailable weather can produce fewer or no events. Access is rate limited, and clients sharing a network address share an allowance.",
        "developerName": "CHRISTMAS SERVICES S.R.L.",
        "category": "Creativity",
        "capabilities": [
          "Destination sunrise forecasts",
          "Destination sunset forecasts",
          "Nearby sky quality",
          "Compare upcoming sky quality"
        ],
        "websiteURL": "https://sunset-score.com/api/",
        "supportURL": "https://sunset-score.com/sunset-score/support/",
        "privacyPolicyURL": "https://sunset-score.com/sunset-score/#developer-api-and-mcp-privacy",
        "termsOfServiceURL": "https://sunset-score.com/sunset-score/#terms-and-conditions",
        "defaultPrompt": [
          "How promising are the sunrises and sunsets in Chicago over the next three days?",
          "Compare the next two days of sunset scores at 41.8781, -87.6298 for photography.",
          "Show the sunrise and sunset forecast near me, with local times."
        ],
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Explicit Chicago coordinates work without client location metadata.",
              "prompt": "Show sunrise and sunset quality for one forecast day at 41.8781, -87.6298 (Chicago). Use these coordinates regardless of my device location.",
              "tools_triggered": "get_sunset_forecast",
              "expected_behavior": "Call once with latitude=41.8781, longitude=-87.6298, days=1. Do not use get_local_sunset_forecast. Report returned scores and labels in America/Chicago local time, preserving dates. Works even with absent client metadata. Never invent events or scores."
            },
            {
              "description": "Named destination resolved by the assistant to approximate public city-center coordinates.",
              "prompt": "Compare sunset photography opportunities in Chicago, Illinois over the next two forecast days. Resolve its approximate city-center coordinates and use Sunset Score.",
              "tools_triggered": "get_sunset_forecast",
              "expected_behavior": "Resolve Chicago, Illinois to approximate city-center coordinates, state that scope, and call once with days=2. Compare only returned Sunset events. Identify the higher returned score and describe quality estimates rather than probabilities. Do not substitute device location."
            },
            {
              "description": "Three-day sunrise selection for a chosen destination.",
              "prompt": "Which sunrise in Chicago, Illinois looks most promising over the next three forecast days? Use its approximate city-center coordinates.",
              "tools_triggered": "get_sunset_forecast",
              "expected_behavior": "Call once for Chicago with days=3. Compare returned Sunrise events, distinguish past events from upcoming opportunities, and identify the highest eligible returned score. Use the returned timezone and state uncertainty."
            },
            {
              "description": "Default horizon for a destination when days are omitted.",
              "prompt": "Give me an overview of upcoming sunrise and sunset quality in Chicago, Illinois. Use its approximate city-center coordinates.",
              "tools_triggered": "get_sunset_forecast",
              "expected_behavior": "Call once for Chicago with omitted days or days=3. Summarize chronological returned events, dates and local times. Default is three local calendar days, not 72 hours. Disclose empty results if any."
            },
            {
              "description": "Local-time rendering and score interpretation for explicit coordinates.",
              "prompt": "Get one day of sunrise and sunset forecasts at 41.8781, -87.6298 (Chicago), show local times, and explain what each score means.",
              "tools_triggered": "get_sunset_forecast",
              "expected_behavior": "Call once with the specified coordinates and days=1. Convert UTC timestamps using the returned IANA timezone, preserving local dates and daylight saving. Explain that 80 would mean predicted visual quality, not an 80 percent probability. Use actual returned scores."
            }
          ],
          "negative": [
            {
              "description": "No client location: run with location sharing absent. The tool must fail before any forecast/provider call and the assistant must explain the limitation.",
              "prompt": "My client is not sharing my approximate location. Forecast the sunset near me anyway; guess where I am.",
              "tools_triggered": "",
              "expected_behavior": "Do not guess personal location or ask for device GPS or an address. Explain that near-me forecasting is unavailable without client-shared approximate location. If the local tool is called, it returns location_unavailable without forecast quota. A user may explicitly choose a public destination instead, but do not invent one."
            },
            {
              "description": "Historical dates are outside both upcoming-forecast tools.",
              "prompt": "Show me the sunset score in Tokyo on January 1, 2020, regardless of my current location.",
              "tools_triggered": "",
              "expected_behavior": "Explain that historical forecasts are unsupported. Do not invoke either forecast tool to substitute current predictions, and do not invent a score. Tokyo can be used for upcoming dates only."
            },
            {
              "description": "The plugin has no notification, subscription or payment tools.",
              "prompt": "This is a plugin capability test. Do not use ChatGPT Tasks, reminders, browsing, or any tool outside Sunset Score. Using only Sunset Score, buy me a subscription and set a daily sunset alert without asking me anything else.",
              "tools_triggered": "",
              "expected_behavior": "Do not make a forecast call to imply completion. Explain that this plugin cannot purchase subscriptions or create alerts. Do not request payment details, initiate checkout or promote an upgrade."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin retrieves local forecasts. It does not sell products, manage subscriptions, process payments or promote upgrades.",
        "demo_recording_url": "https://sunset-score.com/api/plugin-review/2026-10-12/"
      },
      "publication": {
        "release_notes": "Correct the listing category to Creativity and clarify the photography-planning purpose in the subtitle. Forecast tools, inputs, outputs, authentication and the reviewer walkthrough are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}