naftiko: 1.0.0-alpha2 info: label: FactSet ESG API — Factset description: 'FactSet ESG API — Factset. 18 operations. Lead operation: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day.. Self-contained Naftiko capability covering one Factset business surface.' tags: - Factset created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: FACTSET_API_KEY: FACTSET_API_KEY capability: consumes: - type: http namespace: esg-factset baseUri: https://api.factset.com/content description: FactSet ESG API — Factset business capability. Self-contained, no shared references. resources: - name: factset-esg-v1-sasb-articles path: /factset-esg/v1/sasb-articles operations: - name: getsasbarticles method: GET description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsasbarticlesforlist method: POST description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sasb-ranks path: /factset-esg/v1/sasb-ranks operations: - name: getsasbranks method: GET description: Factset Gets Esg Rankings for a Requested List of Ids and Dates. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsasbrankspost method: POST description: Factset Get Esg Ranks for a Large List of Ids and Specified Date Range. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sasb-scores path: /factset-esg/v1/sasb-scores operations: - name: getsasbscores method: GET description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsasbscorespost method: POST description: Factset for a Large List of Ids, Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sasb-scores-all path: /factset-esg/v1/sasb-scores-all operations: - name: getsasbscoresall method: GET description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Scoretype(s). outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsasbscoresallpost method: POST description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Score Type(s). outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sasb-spotlights path: /factset-esg/v1/sasb-spotlights operations: - name: getsasbspotlights method: GET description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsasbspotlightsforlist method: POST description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sdg-articles path: /factset-esg/v1/sdg-articles operations: - name: getsdgarticles method: GET description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsdgarticlesforlist method: POST description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sdg-scores path: /factset-esg/v1/sdg-scores operations: - name: getsdgscores method: GET description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by the United Nations. outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsdgscorespost method: POST description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by United Nations. outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sdg-spotlights path: /factset-esg/v1/sdg-spotlights operations: - name: getsdgspotlights method: GET description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsdgspotlightsforlist method: POST description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: factset-esg-v1-sfdr-pai path: /factset-esg/v1/sfdr-pai operations: - name: getsfdrpai method: GET description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting outputRawFormat: json outputParameters: - name: result type: object value: $. - name: getsfdrpaiforlist method: POST description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true authentication: type: bearer token: '{{env.FACTSET_API_KEY}}' exposes: - type: rest namespace: esg-factset-rest port: 8080 description: REST adapter for FactSet ESG API — Factset. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/factset-esg/v1/sasb-articles name: factset-esg-v1-sasb-articles description: REST surface for factset-esg-v1-sasb-articles. operations: - method: GET name: getsasbarticles description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day. call: esg-factset.getsasbarticles outputParameters: - type: object mapping: $. - method: POST name: getsasbarticlesforlist description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day call: esg-factset.getsasbarticlesforlist with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sasb-ranks name: factset-esg-v1-sasb-ranks description: REST surface for factset-esg-v1-sasb-ranks. operations: - method: GET name: getsasbranks description: Factset Gets Esg Rankings for a Requested List of Ids and Dates. call: esg-factset.getsasbranks outputParameters: - type: object mapping: $. - method: POST name: getsasbrankspost description: Factset Get Esg Ranks for a Large List of Ids and Specified Date Range. call: esg-factset.getsasbrankspost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sasb-scores name: factset-esg-v1-sasb-scores description: REST surface for factset-esg-v1-sasb-scores. operations: - method: GET name: getsasbscores description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). call: esg-factset.getsasbscores outputParameters: - type: object mapping: $. - method: POST name: getsasbscorespost description: Factset for a Large List of Ids, Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). call: esg-factset.getsasbscorespost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sasb-scores-all name: factset-esg-v1-sasb-scores-all description: REST surface for factset-esg-v1-sasb-scores-all. operations: - method: GET name: getsasbscoresall description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Scoretype(s). call: esg-factset.getsasbscoresall outputParameters: - type: object mapping: $. - method: POST name: getsasbscoresallpost description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Score Type(s). call: esg-factset.getsasbscoresallpost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sasb-spotlights name: factset-esg-v1-sasb-spotlights description: REST surface for factset-esg-v1-sasb-spotlights. operations: - method: GET name: getsasbspotlights description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management call: esg-factset.getsasbspotlights outputParameters: - type: object mapping: $. - method: POST name: getsasbspotlightsforlist description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management call: esg-factset.getsasbspotlightsforlist with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sdg-articles name: factset-esg-v1-sdg-articles description: REST surface for factset-esg-v1-sdg-articles. operations: - method: GET name: getsdgarticles description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day. call: esg-factset.getsdgarticles outputParameters: - type: object mapping: $. - method: POST name: getsdgarticlesforlist description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day call: esg-factset.getsdgarticlesforlist with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sdg-scores name: factset-esg-v1-sdg-scores description: REST surface for factset-esg-v1-sdg-scores. operations: - method: GET name: getsdgscores description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by the United Nations. call: esg-factset.getsdgscores outputParameters: - type: object mapping: $. - method: POST name: getsdgscorespost description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by United Nations. call: esg-factset.getsdgscorespost with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sdg-spotlights name: factset-esg-v1-sdg-spotlights description: REST surface for factset-esg-v1-sdg-spotlights. operations: - method: GET name: getsdgspotlights description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management call: esg-factset.getsdgspotlights outputParameters: - type: object mapping: $. - method: POST name: getsdgspotlightsforlist description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management call: esg-factset.getsdgspotlightsforlist with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/factset-esg/v1/sfdr-pai name: factset-esg-v1-sfdr-pai description: REST surface for factset-esg-v1-sfdr-pai. operations: - method: GET name: getsfdrpai description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting call: esg-factset.getsfdrpai outputParameters: - type: object mapping: $. - method: POST name: getsfdrpaiforlist description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting call: esg-factset.getsfdrpaiforlist with: body: rest.body outputParameters: - type: object mapping: $. - type: mcp namespace: esg-factset-mcp port: 9090 transport: http description: MCP adapter for FactSet ESG API — Factset. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: factset-request-articles-tagged-sasb description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day. hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsasbarticles outputParameters: - type: object mapping: $. - name: factset-request-articles-tagged-sasb-2 description: Factset Request Articles Tagged With Sasb Lens Categories From 2016-01-01 to Previous Day hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsasbarticlesforlist with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-esg-rankings-requested description: Factset Gets Esg Rankings for a Requested List of Ids and Dates. hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsasbranks outputParameters: - type: object mapping: $. - name: factset-get-esg-ranks-large description: Factset Get Esg Ranks for a Large List of Ids and Specified Date Range. hints: readOnly: true destructive: false idempotent: false call: esg-factset.getsasbrankspost with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-short-term-long description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsasbscores outputParameters: - type: object mapping: $. - name: factset-large-list-ids-gets description: Factset for a Large List of Ids, Gets Short-term, Long-term, and Momentum Scores Based on the 26 Esg Categories Defined by the Sustainability Accounting Standards Board (sasb). hints: readOnly: true destructive: false idempotent: false call: esg-factset.getsasbscorespost with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-flat-key-value description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Scoretype(s). hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsasbscoresall outputParameters: - type: object mapping: $. - name: factset-gets-flat-key-value-2 description: Factset Gets a Flat Key Value Array of Scores for Named Categories of the Input Score Type(s). hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsasbscoresallpost with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-spotlight-data-most description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsasbspotlights outputParameters: - type: object mapping: $. - name: factset-gets-spotlight-data-most-2 description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsasbspotlightsforlist with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-request-articles-tagged-sdg description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day. hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsdgarticles outputParameters: - type: object mapping: $. - name: factset-request-articles-tagged-sdg-2 description: Factset Request Articles Tagged With Sdg Lens Categories From 2016-01-01 to Previous Day hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsdgarticlesforlist with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-short-term-long-2 description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by the United Nations. hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsdgscores outputParameters: - type: object mapping: $. - name: factset-gets-short-term-long-3 description: Factset Gets Short-term, Long-term, and Momentum Scores Based on the 16 Sustainable Development Goals Categories Defined by United Nations. hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsdgscorespost with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-spotlight-data-most-3 description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsdgspotlights outputParameters: - type: object mapping: $. - name: factset-gets-spotlight-data-most-4 description: Factset Gets Spotlight Data for the Most Important Positive and Negative Esg Events to Enable Timely and Systematic Trading Strategies and Portfolio Management hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsdgspotlightsforlist with: body: tools.body outputParameters: - type: object mapping: $. - name: factset-gets-principle-adverse-impact description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting hints: readOnly: true destructive: false idempotent: true call: esg-factset.getsfdrpai outputParameters: - type: object mapping: $. - name: factset-gets-principle-adverse-impact-2 description: Factset Gets Principle Adverse Impact (pai) Data to Support Compliant Sfdr Sustainable Finance Disclosure Regulation (sfdr) Reporting hints: readOnly: false destructive: false idempotent: false call: esg-factset.getsfdrpaiforlist with: body: tools.body outputParameters: - type: object mapping: $.