naftiko: 1.0.0-alpha2
info:
  label: Refinitiv Data Platform (RDP) APIs — ESG
  description: 'Refinitiv Data Platform (RDP) APIs — ESG. 2 operations. Lead operation: Get Basic ESG Scores. Self-contained
    Naftiko capability covering one Refinitiv business surface.'
  tags:
  - Refinitiv
  - ESG
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    REFINITIV_API_KEY: REFINITIV_API_KEY
capability:
  consumes:
  - type: http
    namespace: data-platform-esg
    baseUri: https://api.refinitiv.com
    description: Refinitiv Data Platform (RDP) APIs — ESG business capability. Self-contained, no shared references.
    resources:
    - name: data-environmental-social-governance-v1-views-basic
      path: /data/environmental-social-governance/v1/views/basic
      operations:
      - name: getesgbasic
        method: GET
        description: Get Basic ESG Scores
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: universe
          in: query
          type: string
          description: Comma-separated list of instrument identifiers.
          required: true
    - name: data-environmental-social-governance-v1-views-measures-full
      path: /data/environmental-social-governance/v1/views/measures-full
      operations:
      - name: getesgmeasuresfull
        method: GET
        description: Get Full ESG Measures
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: universe
          in: query
          type: string
          description: Comma-separated list of instrument identifiers.
          required: true
        - name: start
          in: query
          type: string
          description: Start year for historical ESG data.
        - name: end
          in: query
          type: string
          description: End year for historical ESG data.
    authentication:
      type: bearer
      token: '{{env.REFINITIV_API_KEY}}'
  exposes:
  - type: rest
    namespace: data-platform-esg-rest
    port: 8080
    description: REST adapter for Refinitiv Data Platform (RDP) APIs — ESG. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/data/environmental-social-governance/v1/views/basic
      name: data-environmental-social-governance-v1-views-basic
      description: REST surface for data-environmental-social-governance-v1-views-basic.
      operations:
      - method: GET
        name: getesgbasic
        description: Get Basic ESG Scores
        call: data-platform-esg.getesgbasic
        with:
          universe: rest.universe
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data/environmental-social-governance/v1/views/measures-full
      name: data-environmental-social-governance-v1-views-measures-full
      description: REST surface for data-environmental-social-governance-v1-views-measures-full.
      operations:
      - method: GET
        name: getesgmeasuresfull
        description: Get Full ESG Measures
        call: data-platform-esg.getesgmeasuresfull
        with:
          universe: rest.universe
          start: rest.start
          end: rest.end
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: data-platform-esg-mcp
    port: 9090
    transport: http
    description: MCP adapter for Refinitiv Data Platform (RDP) APIs — ESG. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: get-basic-esg-scores
      description: Get Basic ESG Scores
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-platform-esg.getesgbasic
      with:
        universe: tools.universe
      outputParameters:
      - type: object
        mapping: $.
    - name: get-full-esg-measures
      description: Get Full ESG Measures
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: data-platform-esg.getesgmeasuresfull
      with:
        universe: tools.universe
        start: tools.start
        end: tools.end
      outputParameters:
      - type: object
        mapping: $.