Energy-Charts API

naftiko: 1.0.0-alpha2
info:
  label: Energy-Charts API
  description: '<h4>Timestamp Format Options</h4> <p>When specifying timestamps, you can choose from the following three formats:</p>
    <ol> <li><strong>ISO 8601 Format</strong>: <ul> <li>This format includes the full date and time, with an optional timezone
    indicator.</li> <li>Examples: <ul> <li><code>2025-01-01T17:00Z</code> (UTC time)</li> <li><code>2025-01-01T18:00+01:00</code>
    (Local time offset by +01:00)</li> </ul> </li> </ul> </li> <li><strong>Daily Format</strong>: <ul> <li>This format specifies
    only the date.</li> <li>The start time is assumed to be at 00:00 on the specified date in the local timezone'
  tags:
  - Energy
  - Charts
  - Api
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: energy-charts-api
    baseUri: https://api.example.com
    description: Energy-Charts API HTTP API.
    resources:
    - name: public-power
      path: /public_power
      operations:
      - name: public-power-public-power-get
        method: GET
        description: Public Power
        inputParameters:
        - name: country
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        - name: subtype
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: public-power-forecast
      path: /public_power_forecast
      operations:
      - name: public-power-forecast-public-power-forecast-get
        method: GET
        description: Public Power Forecast
        inputParameters:
        - name: country
          in: query
          type: string
        - name: production_type
          in: query
          type: string
        - name: forecast_type
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: total-power
      path: /total_power
      operations:
      - name: total-power-total-power-get
        method: GET
        description: Total Power
        inputParameters:
        - name: country
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: installed-power
      path: /installed_power
      operations:
      - name: installed-power-installed-power-get
        method: GET
        description: Installed Power
        inputParameters:
        - name: country
          in: query
          type: string
        - name: time_step
          in: query
          type: string
        - name: installation_decommission
          in: query
          type: boolean
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: price
      path: /price
      operations:
      - name: day-ahead-price-price-get
        method: GET
        description: Day Ahead Price
        inputParameters:
        - name: bzn
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cbet
      path: /cbet
      operations:
      - name: cross-border-electricity-trading-cbet-get
        method: GET
        description: Cross Border Electricity Trading
        inputParameters:
        - name: country
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: cbpf
      path: /cbpf
      operations:
      - name: cross-border-physical-flows-cbpf-get
        method: GET
        description: Cross Border Physical Flows
        inputParameters:
        - name: country
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: signal
      path: /signal
      operations:
      - name: traffic-signal-signal-get
        method: GET
        description: Traffic Signal
        inputParameters:
        - name: country
          in: query
          type: string
        - name: postal_code
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ren-share-forecast
      path: /ren_share_forecast
      operations:
      - name: renewable-share-forecast-ren-share-forecast-get
        method: GET
        description: Renewable Share Forecast
        inputParameters:
        - name: country
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: ren-share-daily-avg
      path: /ren_share_daily_avg
      operations:
      - name: ren-share-daily-avg-ren-share-daily-avg-get
        method: GET
        description: Ren Share Daily Avg
        inputParameters:
        - name: country
          in: query
          type: string
        - name: year
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: solar-share
      path: /solar_share
      operations:
      - name: solar-share-solar-share-get
        method: GET
        description: Solar Share
        inputParameters:
        - name: country
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: solar-share-daily-avg
      path: /solar_share_daily_avg
      operations:
      - name: solar-share-daily-avg-solar-share-daily-avg-get
        method: GET
        description: Solar Share Daily Avg
        inputParameters:
        - name: country
          in: query
          type: string
        - name: year
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wind-onshore-share
      path: /wind_onshore_share
      operations:
      - name: wind-onshore-share-wind-onshore-share-get
        method: GET
        description: Wind Onshore Share
        inputParameters:
        - name: country
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wind-onshore-share-daily-avg
      path: /wind_onshore_share_daily_avg
      operations:
      - name: wind-onshore-share-daily-avg-wind-onshore-share-
        method: GET
        description: Wind Onshore Share Daily Avg
        inputParameters:
        - name: country
          in: query
          type: string
        - name: year
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wind-offshore-share
      path: /wind_offshore_share
      operations:
      - name: wind-offshore-share-wind-offshore-share-get
        method: GET
        description: Wind Offshore Share
        inputParameters:
        - name: country
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: wind-offshore-share-daily-avg
      path: /wind_offshore_share_daily_avg
      operations:
      - name: wind-offshore-share-daily-avg-wind-offshore-shar
        method: GET
        description: Wind Offshore Share Daily Avg
        inputParameters:
        - name: country
          in: query
          type: string
        - name: year
          in: query
          type: integer
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: frequency
      path: /frequency
      operations:
      - name: frequency-frequency-get
        method: GET
        description: Frequency
        inputParameters:
        - name: region
          in: query
          type: string
        - name: start
          in: query
          type: string
        - name: end
          in: query
          type: string
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: energy-charts-api-rest
    description: REST adapter for Energy-Charts API.
    resources:
    - path: /public_power
      name: public-power-public-power-get
      operations:
      - method: GET
        name: public-power-public-power-get
        description: Public Power
        call: energy-charts-api.public-power-public-power-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /public_power_forecast
      name: public-power-forecast-public-power-forecast-get
      operations:
      - method: GET
        name: public-power-forecast-public-power-forecast-get
        description: Public Power Forecast
        call: energy-charts-api.public-power-forecast-public-power-forecast-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /total_power
      name: total-power-total-power-get
      operations:
      - method: GET
        name: total-power-total-power-get
        description: Total Power
        call: energy-charts-api.total-power-total-power-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /installed_power
      name: installed-power-installed-power-get
      operations:
      - method: GET
        name: installed-power-installed-power-get
        description: Installed Power
        call: energy-charts-api.installed-power-installed-power-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /price
      name: day-ahead-price-price-get
      operations:
      - method: GET
        name: day-ahead-price-price-get
        description: Day Ahead Price
        call: energy-charts-api.day-ahead-price-price-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /cbet
      name: cross-border-electricity-trading-cbet-get
      operations:
      - method: GET
        name: cross-border-electricity-trading-cbet-get
        description: Cross Border Electricity Trading
        call: energy-charts-api.cross-border-electricity-trading-cbet-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /cbpf
      name: cross-border-physical-flows-cbpf-get
      operations:
      - method: GET
        name: cross-border-physical-flows-cbpf-get
        description: Cross Border Physical Flows
        call: energy-charts-api.cross-border-physical-flows-cbpf-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /signal
      name: traffic-signal-signal-get
      operations:
      - method: GET
        name: traffic-signal-signal-get
        description: Traffic Signal
        call: energy-charts-api.traffic-signal-signal-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /ren_share_forecast
      name: renewable-share-forecast-ren-share-forecast-get
      operations:
      - method: GET
        name: renewable-share-forecast-ren-share-forecast-get
        description: Renewable Share Forecast
        call: energy-charts-api.renewable-share-forecast-ren-share-forecast-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /ren_share_daily_avg
      name: ren-share-daily-avg-ren-share-daily-avg-get
      operations:
      - method: GET
        name: ren-share-daily-avg-ren-share-daily-avg-get
        description: Ren Share Daily Avg
        call: energy-charts-api.ren-share-daily-avg-ren-share-daily-avg-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /solar_share
      name: solar-share-solar-share-get
      operations:
      - method: GET
        name: solar-share-solar-share-get
        description: Solar Share
        call: energy-charts-api.solar-share-solar-share-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /solar_share_daily_avg
      name: solar-share-daily-avg-solar-share-daily-avg-get
      operations:
      - method: GET
        name: solar-share-daily-avg-solar-share-daily-avg-get
        description: Solar Share Daily Avg
        call: energy-charts-api.solar-share-daily-avg-solar-share-daily-avg-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /wind_onshore_share
      name: wind-onshore-share-wind-onshore-share-get
      operations:
      - method: GET
        name: wind-onshore-share-wind-onshore-share-get
        description: Wind Onshore Share
        call: energy-charts-api.wind-onshore-share-wind-onshore-share-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /wind_onshore_share_daily_avg
      name: wind-onshore-share-daily-avg-wind-onshore-share
      operations:
      - method: GET
        name: wind-onshore-share-daily-avg-wind-onshore-share-
        description: Wind Onshore Share Daily Avg
        call: energy-charts-api.wind-onshore-share-daily-avg-wind-onshore-share-
        outputParameters:
        - type: object
          mapping: $.
    - path: /wind_offshore_share
      name: wind-offshore-share-wind-offshore-share-get
      operations:
      - method: GET
        name: wind-offshore-share-wind-offshore-share-get
        description: Wind Offshore Share
        call: energy-charts-api.wind-offshore-share-wind-offshore-share-get
        outputParameters:
        - type: object
          mapping: $.
    - path: /wind_offshore_share_daily_avg
      name: wind-offshore-share-daily-avg-wind-offshore-shar
      operations:
      - method: GET
        name: wind-offshore-share-daily-avg-wind-offshore-shar
        description: Wind Offshore Share Daily Avg
        call: energy-charts-api.wind-offshore-share-daily-avg-wind-offshore-shar
        outputParameters:
        - type: object
          mapping: $.
    - path: /frequency
      name: frequency-frequency-get
      operations:
      - method: GET
        name: frequency-frequency-get
        description: Frequency
        call: energy-charts-api.frequency-frequency-get
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: energy-charts-api-mcp
    transport: http
    description: MCP adapter for Energy-Charts API for AI agent use.
    tools:
    - name: public-power-public-power-get
      description: Public Power
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.public-power-public-power-get
      with:
        country: tools.country
        start: tools.start
        end: tools.end
        subtype: tools.subtype
      inputParameters:
      - name: country
        type: string
        description: country
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      - name: subtype
        type: string
        description: subtype
      outputParameters:
      - type: object
        mapping: $.
    - name: public-power-forecast-public-power-forecast-get
      description: Public Power Forecast
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.public-power-forecast-public-power-forecast-get
      with:
        country: tools.country
        production_type: tools.production_type
        forecast_type: tools.forecast_type
        start: tools.start
        end: tools.end
      inputParameters:
      - name: country
        type: string
        description: country
      - name: production_type
        type: string
        description: production_type
      - name: forecast_type
        type: string
        description: forecast_type
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.
    - name: total-power-total-power-get
      description: Total Power
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.total-power-total-power-get
      with:
        country: tools.country
        start: tools.start
        end: tools.end
      inputParameters:
      - name: country
        type: string
        description: country
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.
    - name: installed-power-installed-power-get
      description: Installed Power
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.installed-power-installed-power-get
      with:
        country: tools.country
        time_step: tools.time_step
        installation_decommission: tools.installation_decommission
      inputParameters:
      - name: country
        type: string
        description: country
      - name: time_step
        type: string
        description: time_step
      - name: installation_decommission
        type: boolean
        description: installation_decommission
      outputParameters:
      - type: object
        mapping: $.
    - name: day-ahead-price-price-get
      description: Day Ahead Price
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.day-ahead-price-price-get
      with:
        bzn: tools.bzn
        start: tools.start
        end: tools.end
      inputParameters:
      - name: bzn
        type: string
        description: bzn
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.
    - name: cross-border-electricity-trading-cbet-get
      description: Cross Border Electricity Trading
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.cross-border-electricity-trading-cbet-get
      with:
        country: tools.country
        start: tools.start
        end: tools.end
      inputParameters:
      - name: country
        type: string
        description: country
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.
    - name: cross-border-physical-flows-cbpf-get
      description: Cross Border Physical Flows
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.cross-border-physical-flows-cbpf-get
      with:
        country: tools.country
        start: tools.start
        end: tools.end
      inputParameters:
      - name: country
        type: string
        description: country
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.
    - name: traffic-signal-signal-get
      description: Traffic Signal
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.traffic-signal-signal-get
      with:
        country: tools.country
        postal_code: tools.postal_code
      inputParameters:
      - name: country
        type: string
        description: country
      - name: postal_code
        type: string
        description: postal_code
      outputParameters:
      - type: object
        mapping: $.
    - name: renewable-share-forecast-ren-share-forecast-get
      description: Renewable Share Forecast
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.renewable-share-forecast-ren-share-forecast-get
      with:
        country: tools.country
      inputParameters:
      - name: country
        type: string
        description: country
      outputParameters:
      - type: object
        mapping: $.
    - name: ren-share-daily-avg-ren-share-daily-avg-get
      description: Ren Share Daily Avg
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.ren-share-daily-avg-ren-share-daily-avg-get
      with:
        country: tools.country
        year: tools.year
      inputParameters:
      - name: country
        type: string
        description: country
      - name: year
        type: integer
        description: year
      outputParameters:
      - type: object
        mapping: $.
    - name: solar-share-solar-share-get
      description: Solar Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.solar-share-solar-share-get
      with:
        country: tools.country
      inputParameters:
      - name: country
        type: string
        description: country
      outputParameters:
      - type: object
        mapping: $.
    - name: solar-share-daily-avg-solar-share-daily-avg-get
      description: Solar Share Daily Avg
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.solar-share-daily-avg-solar-share-daily-avg-get
      with:
        country: tools.country
        year: tools.year
      inputParameters:
      - name: country
        type: string
        description: country
      - name: year
        type: integer
        description: year
      outputParameters:
      - type: object
        mapping: $.
    - name: wind-onshore-share-wind-onshore-share-get
      description: Wind Onshore Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.wind-onshore-share-wind-onshore-share-get
      with:
        country: tools.country
      inputParameters:
      - name: country
        type: string
        description: country
      outputParameters:
      - type: object
        mapping: $.
    - name: wind-onshore-share-daily-avg-wind-onshore-share-
      description: Wind Onshore Share Daily Avg
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.wind-onshore-share-daily-avg-wind-onshore-share-
      with:
        country: tools.country
        year: tools.year
      inputParameters:
      - name: country
        type: string
        description: country
      - name: year
        type: integer
        description: year
      outputParameters:
      - type: object
        mapping: $.
    - name: wind-offshore-share-wind-offshore-share-get
      description: Wind Offshore Share
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.wind-offshore-share-wind-offshore-share-get
      with:
        country: tools.country
      inputParameters:
      - name: country
        type: string
        description: country
      outputParameters:
      - type: object
        mapping: $.
    - name: wind-offshore-share-daily-avg-wind-offshore-shar
      description: Wind Offshore Share Daily Avg
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.wind-offshore-share-daily-avg-wind-offshore-shar
      with:
        country: tools.country
        year: tools.year
      inputParameters:
      - name: country
        type: string
        description: country
      - name: year
        type: integer
        description: year
      outputParameters:
      - type: object
        mapping: $.
    - name: frequency-frequency-get
      description: Frequency
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: energy-charts-api.frequency-frequency-get
      with:
        region: tools.region
        start: tools.start
        end: tools.end
      inputParameters:
      - name: region
        type: string
        description: region
      - name: start
        type: string
        description: start
      - name: end
        type: string
        description: end
      outputParameters:
      - type: object
        mapping: $.