naftiko: 1.0.0-alpha2
info:
  label: Solcast Solar Resource Assessment
  description: Workflow capability for solar resource assessment, project financing, and long-term yield analysis. Combines
    historical irradiance, rooftop and advanced PV power histories, TMY data, historical soiling models, and PV site management.
    Used by project developers, asset managers, banks, and energy consultants performing bankable resource assessments and
    yield studies.
  tags:
  - Solar
  - Resource Assessment
  - Historical Data
  - TMY
  - PV Power
  - Soiling
  - Project Finance
  - Yield Analysis
  - Renewable Energy
  created: '2026-05-02'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    SOLCAST_API_KEY: SOLCAST_API_KEY
capability:
  consumes:
  - type: http
    namespace: solcast
    baseUri: https://api.solcast.com.au
    description: Solcast solar irradiance, PV power, weather forecasting, and site management API.
    authentication:
      type: bearer
      token: '{{SOLCAST_API_KEY}}'
    resources:
    - name: live-radiation-and-weather
      path: /data/live/radiation_and_weather
      description: Real-time satellite-derived solar irradiance and weather data for a location (last 7 days, updated every
        5 minutes).
      operations:
      - name: get-live-radiation-and-weather
        method: GET
        description: Get live irradiance and weather estimated actuals for a lat/lon location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees (-90 to 90, north positive).
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees (-180 to 180, east positive).
        - name: output_parameters
          in: query
          type: string
          required: true
          description: Comma-separated output parameters (e.g., ghi,dni,dhi,air_temp).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601, e.g., PT30M).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: live-rooftop-pv-power
      path: /data/live/rooftop_pv_power
      description: Live rooftop PV power estimated actuals by location without site registration.
      operations:
      - name: get-live-rooftop-pv-power
        method: GET
        description: Get live rooftop PV power estimated actuals for a lat/lon location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: capacity
          in: query
          type: number
          required: false
          description: System capacity in kilowatts.
        - name: tilt
          in: query
          type: number
          required: false
          description: Panel tilt angle in degrees.
        - name: azimuth
          in: query
          type: number
          required: false
          description: Panel azimuth in degrees.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: live-advanced-pv-power
      path: /data/live/advanced_pv_power
      description: Live high-specification PV power actuals for a registered PV site.
      operations:
      - name: get-live-advanced-pv-power
        method: GET
        description: Get live advanced PV power actuals for a registered PV power site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for a registered Solcast PV power site.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: live-soiling-kimber
      path: /data/live/soiling/kimber
      description: Live hourly soiling loss estimates using the Kimber model.
      operations:
      - name: get-live-soiling-kimber
        method: GET
        description: Get live soiling loss estimates for a location using the Kimber model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction (0.0 = clean).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: live-soiling-hsu
      path: /data/live/soiling/hsu
      description: Live hourly soiling loss estimates using Solcast's HSU model.
      operations:
      - name: get-live-soiling-hsu
        method: GET
        description: Get live soiling loss estimates for a location using the HSU model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction (0.0 = clean).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-radiation-and-weather
      path: /data/forecast/radiation_and_weather
      description: Solar irradiance and weather forecasts up to 14 days ahead for a location.
      operations:
      - name: get-forecast-radiation-and-weather
        method: GET
        description: Get irradiance and weather forecasts up to 14 days ahead for a lat/lon location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: output_parameters
          in: query
          type: string
          required: true
          description: Comma-separated output parameters.
        - name: hours
          in: query
          type: integer
          required: false
          description: Number of forecast hours to retrieve (up to 336 / 14 days).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-rooftop-pv-power
      path: /data/forecast/rooftop_pv_power
      description: Rooftop PV power forecasts up to 14 days ahead by location.
      operations:
      - name: get-forecast-rooftop-pv-power
        method: GET
        description: Get basic rooftop PV power forecasts up to 14 days ahead for a lat/lon location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: output_parameters
          in: query
          type: string
          required: true
          description: Comma-separated output parameters.
        - name: capacity
          in: query
          type: number
          required: false
          description: System capacity in kilowatts.
        - name: tilt
          in: query
          type: number
          required: false
          description: Panel tilt in degrees.
        - name: azimuth
          in: query
          type: number
          required: false
          description: Panel azimuth in degrees.
        - name: hours
          in: query
          type: integer
          required: false
          description: Number of forecast hours to retrieve (up to 336).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-advanced-pv-power
      path: /data/forecast/advanced_pv_power
      description: Advanced PV power forecasts up to 14 days ahead for a registered site.
      operations:
      - name: get-forecast-advanced-pv-power
        method: GET
        description: Get advanced PV power forecasts up to 14 days ahead for a registered site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for a registered Solcast PV power site.
        - name: hours
          in: query
          type: integer
          required: false
          description: Number of forecast hours to retrieve (up to 336).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-soiling-kimber
      path: /data/forecast/soiling/kimber
      description: Hourly soiling loss forecasts using the Kimber model.
      operations:
      - name: get-forecast-soiling-kimber
        method: GET
        description: Get soiling loss forecasts for a location using the Kimber model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction.
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-soiling-hsu
      path: /data/forecast/soiling/hsu
      description: Hourly soiling loss forecasts using the HSU model.
      operations:
      - name: get-forecast-soiling-hsu
        method: GET
        description: Get soiling loss forecasts for a location using the HSU model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction.
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: forecast-aggregations
      path: /data/forecast/aggregations
      description: Forecast aggregation data for grid collections or sub-aggregations.
      operations:
      - name: get-forecast-aggregations
        method: GET
        description: Get forecast aggregation data for a grid collection or sub-aggregation.
        inputParameters:
        - name: collection_id
          in: query
          type: string
          required: true
          description: Unique identifier for the grid aggregation collection.
        - name: aggregation_id
          in: query
          type: string
          required: false
          description: Unique identifier for a sub-aggregation within the collection.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historic-radiation-and-weather
      path: /data/historic/radiation_and_weather
      description: Historical irradiance and weather data from 2007 to 7 days before present.
      operations:
      - name: get-historic-radiation-and-weather
        method: GET
        description: Get historical irradiance and weather for up to 31 days at a time from 2007 to present minus 7 days.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: start
          in: query
          type: string
          required: true
          description: Start of requested period (ISO 8601 date or datetime).
        - name: end
          in: query
          type: string
          required: false
          description: End of requested period (mutually exclusive with duration).
        - name: duration
          in: query
          type: string
          required: false
          description: ISO 8601 duration within 31 days (mutually exclusive with end).
        - name: output_parameters
          in: query
          type: string
          required: false
          description: Comma-separated output parameters.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historic-rooftop-pv-power
      path: /data/historic/rooftop_pv_power
      description: Historical rooftop PV power data from 2007 to 7 days before present.
      operations:
      - name: get-historic-rooftop-pv-power
        method: GET
        description: Get historical rooftop PV power estimated actuals for a location.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: start
          in: query
          type: string
          required: true
          description: Start of requested period (ISO 8601).
        - name: end
          in: query
          type: string
          required: false
          description: End of requested period (mutually exclusive with duration).
        - name: duration
          in: query
          type: string
          required: false
          description: ISO 8601 duration within 31 days (mutually exclusive with end).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historic-advanced-pv-power
      path: /data/historic/advanced_pv_power
      description: Historical advanced PV power data for a registered site from 2007 to present minus 7 days.
      operations:
      - name: get-historic-advanced-pv-power
        method: GET
        description: Get historical advanced PV power estimated actuals for a registered site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for a registered Solcast PV power site.
        - name: start
          in: query
          type: string
          required: true
          description: Start of requested period (ISO 8601).
        - name: end
          in: query
          type: string
          required: false
          description: End of requested period (mutually exclusive with duration).
        - name: duration
          in: query
          type: string
          required: false
          description: ISO 8601 duration within 31 days (mutually exclusive with end).
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historic-soiling-kimber
      path: /data/historic/soiling/kimber
      description: Historical hourly soiling loss estimates using the Kimber model.
      operations:
      - name: get-historic-soiling-kimber
        method: GET
        description: Get historical soiling loss estimates using the Kimber model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: start
          in: query
          type: string
          required: true
          description: Start of requested period (ISO 8601).
        - name: end
          in: query
          type: string
          required: false
          description: End of requested period.
        - name: duration
          in: query
          type: string
          required: false
          description: ISO 8601 duration within 31 days.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction.
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: historic-soiling-hsu
      path: /data/historic/soiling/hsu
      description: Historical hourly soiling loss estimates using the HSU model.
      operations:
      - name: get-historic-soiling-hsu
        method: GET
        description: Get historical soiling loss estimates using the HSU model.
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: start
          in: query
          type: string
          required: true
          description: Start of requested period (ISO 8601).
        - name: end
          in: query
          type: string
          required: false
          description: End of requested period.
        - name: duration
          in: query
          type: string
          required: false
          description: ISO 8601 duration within 31 days.
        - name: depo_veloc_pm10
          in: query
          type: number
          required: false
          description: Deposition velocity for PM10 particles (m/s).
        - name: initial_soiling
          in: query
          type: number
          required: false
          description: Initial soiling fraction.
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tmy-radiation-and-weather
      path: /data/tmy/radiation_and_weather
      description: Typical Meteorological Year irradiance and weather data (2007-2023).
      operations:
      - name: get-tmy-radiation-and-weather
        method: GET
        description: Get TMY irradiance and weather data for a location (computed from 2007-2023).
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: output_parameters
          in: query
          type: string
          required: false
          description: Comma-separated output parameters.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tmy-rooftop-pv-power
      path: /data/tmy/rooftop_pv_power
      description: Typical Meteorological Year rooftop PV power data (2007-2023).
      operations:
      - name: get-tmy-rooftop-pv-power
        method: GET
        description: Get TMY rooftop PV power data for a location (computed from 2007-2023).
        inputParameters:
        - name: latitude
          in: query
          type: number
          required: true
          description: Latitude in decimal degrees.
        - name: longitude
          in: query
          type: number
          required: true
          description: Longitude in decimal degrees.
        - name: capacity
          in: query
          type: number
          required: false
          description: System capacity in kilowatts.
        - name: tilt
          in: query
          type: number
          required: false
          description: Panel tilt in degrees.
        - name: azimuth
          in: query
          type: number
          required: false
          description: Panel azimuth in degrees.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: live-aggregations
      path: /data/live/aggregations
      description: Live aggregation data for grid collections or sub-aggregations.
      operations:
      - name: get-live-aggregations
        method: GET
        description: Get live aggregation data for a grid collection or sub-aggregation.
        inputParameters:
        - name: collection_id
          in: query
          type: string
          required: true
          description: Unique identifier for the grid aggregation collection.
        - name: aggregation_id
          in: query
          type: string
          required: false
          description: Unique identifier for a sub-aggregation within the collection.
        - name: period
          in: query
          type: string
          required: false
          description: Time period between data points (ISO 8601).
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pv-power-sites
      path: /resources/pv_power_sites
      description: List all registered PV power sites for the authenticated account.
      operations:
      - name: list-pv-power-sites
        method: GET
        description: List all registered Solcast PV power sites.
        inputParameters:
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pv-power-site
      path: /resources/pv_power_site
      description: CRUD management of individual registered PV power sites.
      operations:
      - name: get-pv-power-site
        method: GET
        description: Get specifications and metadata for a specific registered PV power site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for the PV power site.
        - name: format
          in: query
          type: string
          required: false
          description: 'Response format: json or csv.'
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: create-pv-power-site
        method: POST
        description: Create a new PV power site for use with the advanced PV power model.
        inputParameters: []
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            latitude: '{{tools.latitude}}'
            longitude: '{{tools.longitude}}'
            capacity: '{{tools.capacity}}'
            tilt: '{{tools.tilt}}'
            azimuth: '{{tools.azimuth}}'
      - name: patch-pv-power-site
        method: PATCH
        description: Partially update specifications of an existing PV power site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for the PV power site to update.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            capacity: '{{tools.capacity}}'
      - name: update-pv-power-site
        method: PUT
        description: Fully overwrite specifications of an existing PV power site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for the PV power site to overwrite.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        body:
          type: json
          data:
            name: '{{tools.name}}'
            latitude: '{{tools.latitude}}'
            longitude: '{{tools.longitude}}'
            capacity: '{{tools.capacity}}'
      - name: delete-pv-power-site
        method: DELETE
        description: Permanently delete a registered PV power site.
        inputParameters:
        - name: resource_id
          in: query
          type: string
          required: true
          description: Unique identifier for the PV power site to delete.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8081
    namespace: solar-resource-assessment-api
    description: Unified REST API for solar resource assessment and long-term yield analysis.
    resources:
    - path: /v1/historic/radiation-and-weather
      name: historic-radiation-and-weather
      description: Historical irradiance and weather data from 2007 onwards.
      operations:
      - method: GET
        name: get-historic-radiation-and-weather
        description: Get historical irradiance and weather for up to 31 days at a time.
        call: solcast.get-historic-radiation-and-weather
        with:
          latitude: rest.latitude
          longitude: rest.longitude
          start: rest.start
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/historic/rooftop-pv-power
      name: historic-rooftop-pv-power
      description: Historical rooftop PV power data from 2007 onwards.
      operations:
      - method: GET
        name: get-historic-rooftop-pv-power
        description: Get historical rooftop PV power estimated actuals for a location.
        call: solcast.get-historic-rooftop-pv-power
        with:
          latitude: rest.latitude
          longitude: rest.longitude
          start: rest.start
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/historic/advanced-pv-power
      name: historic-advanced-pv-power
      description: Historical advanced PV power data for registered sites.
      operations:
      - method: GET
        name: get-historic-advanced-pv-power
        description: Get historical advanced PV power actuals for a registered site.
        call: solcast.get-historic-advanced-pv-power
        with:
          resource_id: rest.resource_id
          start: rest.start
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/historic/soiling
      name: historic-soiling
      description: Historical soiling loss data using Kimber or HSU models.
      operations:
      - method: GET
        name: get-historic-soiling-kimber
        description: Get historical soiling loss using the Kimber model.
        call: solcast.get-historic-soiling-kimber
        with:
          latitude: rest.latitude
          longitude: rest.longitude
          start: rest.start
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tmy/radiation-and-weather
      name: tmy-radiation-and-weather
      description: Typical Meteorological Year irradiance and weather (2007-2023).
      operations:
      - method: GET
        name: get-tmy-radiation-and-weather
        description: Get TMY irradiance and weather for a location.
        call: solcast.get-tmy-radiation-and-weather
        with:
          latitude: rest.latitude
          longitude: rest.longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tmy/rooftop-pv-power
      name: tmy-rooftop-pv-power
      description: Typical Meteorological Year rooftop PV power (2007-2023).
      operations:
      - method: GET
        name: get-tmy-rooftop-pv-power
        description: Get TMY rooftop PV power data for a location.
        call: solcast.get-tmy-rooftop-pv-power
        with:
          latitude: rest.latitude
          longitude: rest.longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pv-power-sites
      name: pv-power-sites
      description: Manage registered PV power sites for advanced model access.
      operations:
      - method: GET
        name: list-pv-power-sites
        description: List all registered PV power sites.
        call: solcast.list-pv-power-sites
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: create-pv-power-site
        description: Create a new PV power site.
        call: solcast.create-pv-power-site
        with:
          name: rest.name
          latitude: rest.latitude
          longitude: rest.longitude
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/pv-power-sites/{resource_id}
      name: pv-power-site
      description: Individual PV power site management.
      operations:
      - method: GET
        name: get-pv-power-site
        description: Get a specific PV power site.
        call: solcast.get-pv-power-site
        with:
          resource_id: rest.resource_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: patch-pv-power-site
        description: Partially update a PV power site.
        call: solcast.patch-pv-power-site
        with:
          resource_id: rest.resource_id
        outputParameters:
        - type: object
          mapping: $.
      - method: PUT
        name: update-pv-power-site
        description: Fully overwrite a PV power site.
        call: solcast.update-pv-power-site
        with:
          resource_id: rest.resource_id
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: delete-pv-power-site
        description: Delete a PV power site.
        call: solcast.delete-pv-power-site
        with:
          resource_id: rest.resource_id
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9081
    namespace: solar-resource-assessment-mcp
    transport: http
    description: MCP server for AI-assisted solar resource assessment and long-term yield analysis.
    tools:
    - name: get-historic-radiation-and-weather
      description: Get historical solar irradiance and weather from 2007 to 7 days before present (up to 31 days per call).
        Use for bankable resource assessment and P50/P90 yield studies.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-historic-radiation-and-weather
      with:
        latitude: tools.latitude
        longitude: tools.longitude
        start: tools.start
      outputParameters:
      - type: object
        mapping: $.
    - name: get-historic-rooftop-pv-power
      description: Get historical rooftop PV power estimated actuals from 2007 onwards. Use for yield analysis and performance
        benchmarking.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-historic-rooftop-pv-power
      with:
        latitude: tools.latitude
        longitude: tools.longitude
        start: tools.start
      outputParameters:
      - type: object
        mapping: $.
    - name: get-historic-advanced-pv-power
      description: Get historical advanced PV power actuals for a registered site. Use for detailed yield analysis with site-specific
        PV model.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-historic-advanced-pv-power
      with:
        resource_id: tools.resource_id
        start: tools.start
      outputParameters:
      - type: object
        mapping: $.
    - name: get-historic-soiling-kimber
      description: Get historical soiling loss estimates using the Kimber model. Use for yield loss analysis and cleaning
        schedule optimization.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-historic-soiling-kimber
      with:
        latitude: tools.latitude
        longitude: tools.longitude
        start: tools.start
      outputParameters:
      - type: object
        mapping: $.
    - name: get-historic-soiling-hsu
      description: Get historical soiling loss estimates using the HSU model.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-historic-soiling-hsu
      with:
        latitude: tools.latitude
        longitude: tools.longitude
        start: tools.start
      outputParameters:
      - type: object
        mapping: $.
    - name: get-tmy-radiation-and-weather
      description: Get Typical Meteorological Year irradiance and weather (2007-2023). Use for long-run average yield studies
        and project feasibility.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-tmy-radiation-and-weather
      with:
        latitude: tools.latitude
        longitude: tools.longitude
      outputParameters:
      - type: object
        mapping: $.
    - name: get-tmy-rooftop-pv-power
      description: Get Typical Meteorological Year rooftop PV power data (2007-2023). Use for annual yield estimation and
        project financing.
      hints:
        readOnly: true
        openWorld: true
      call: solcast.get-tmy-rooftop-pv-power
      with:
        latitude: tools.latitude
        longitude: tools.longitude
      outputParameters:
      - type: object
        mapping: $.
    - name: list-pv-power-sites
      description: List all registered PV power sites for this account.
      hints:
        readOnly: true
        openWorld: false
      call: solcast.list-pv-power-sites
      outputParameters:
      - type: object
        mapping: $.
    - name: get-pv-power-site
      description: Get specifications for a specific registered PV power site.
      hints:
        readOnly: true
        openWorld: false
      call: solcast.get-pv-power-site
      with:
        resource_id: tools.resource_id
      outputParameters:
      - type: object
        mapping: $.
    - name: create-pv-power-site
      description: Register a new PV power site with Solcast for advanced PV power model access. Requires site name, latitude,
        and longitude.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: solcast.create-pv-power-site
      with:
        name: tools.name
        latitude: tools.latitude
        longitude: tools.longitude
        capacity: tools.capacity
      outputParameters:
      - type: object
        mapping: $.
    - name: patch-pv-power-site
      description: Partially update an existing PV power site's specifications (e.g., update capacity or tilt after hardware
        changes).
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: solcast.patch-pv-power-site
      with:
        resource_id: tools.resource_id
      outputParameters:
      - type: object
        mapping: $.
    - name: update-pv-power-site
      description: Fully replace an existing PV power site's specifications.
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: solcast.update-pv-power-site
      with:
        resource_id: tools.resource_id
      outputParameters:
      - type: object
        mapping: $.
    - name: delete-pv-power-site
      description: Permanently delete a registered PV power site.
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: solcast.delete-pv-power-site
      with:
        resource_id: tools.resource_id
      outputParameters:
      - type: object
        mapping: $.