Factset Chart Generation Service — Image

naftiko: 1.0.0-alpha2
info:
  label: Factset Chart Generation Service — Image
  description: 'Factset Chart Generation Service — Image. 1 operations. Lead operation: Factset Get chart image back in PNG
    or JPEG formats. Self-contained Naftiko capability covering one Factset business surface.'
  tags:
  - Factset
  - Image
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    FACTSET_API_KEY: FACTSET_API_KEY
capability:
  consumes:
  - type: http
    namespace: chart-generation-service-image
    baseUri: https://api-sandbox.factset.com/charting
    description: Factset Chart Generation Service — Image business capability. Self-contained, no shared references.
    resources:
    - name: v1-image
      path: /v1/image
      operations:
      - name: images
        method: GET
        description: Factset Get chart image back in PNG or JPEG formats
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: chart
          in: query
          type: string
          description: Path to the saved chart. For any of the default charts, the option should be `categoryName + '/' +
            chartName`. For charts under the Client or Personal directori
          required: true
        - name: ids
          in: query
          type: string
          description: 'List of identifiers to be charted in a comma(,) separated string. Only the first one would be considered
            as primary and rest would be added as comps. Check the '
        - name: sd
          in: query
          type: string
          description: Option for overriding the startDate of the chart. For absolute dates provide a string in `YYYYMMDD`
            format. We can also specify relative date options
        - name: ed
          in: query
          type: string
          description: Option for overriding the endDate of the chart. For absolute dates provide a string in `YYYYMMDD` format.
            We can also specify relative date options
        - name: width
          in: query
          type: integer
          description: Option for setting the width of the image
        - name: height
          in: query
          type: integer
          description: Option for setting the height of the image
        - name: freq
          in: query
          type: string
          description: A shorthand string for the overall frequency of the chart like `D` (daily), `W` (weekly), `Y` (yearly)
            and `Q` (Quarterly). This will default to frequency store
        - name: ccy
          in: query
          type: string
          description: Currency ISO code for the overall currency of the chart. The API doesn't allow per series currency
            at this point in time.
        - name: split
          in: query
          type: string
          description: Option to specify the splits adjustment
        - name: spin
          in: query
          type: number
          description: Numeric option to specify the spinOffs adjustment. Possible options include `0` (When we only want
            spits adjustment), `1` (spinOffs), `4` (spinOffs and cash div
        - name: cal
          in: query
          type: string
          description: Option for the calendarType of the chart
        - name: title
          in: query
          type: string
          description: Option to customize the title. If you don't customize the title, then it displays by default the security
            name.
        - name: fontSize
          in: query
          type: number
          description: Option to adjust chart's fontSize
        - name: type
          in: query
          type: string
          description: The type of image to be generated by the service
        - name: gridLines
          in: query
          type: boolean
          description: Option to toggle gridLines on/off on the chart
  exposes:
  - type: rest
    namespace: chart-generation-service-image-rest
    port: 8080
    description: REST adapter for Factset Chart Generation Service — Image. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/image
      name: v1-image
      description: REST surface for v1-image.
      operations:
      - method: GET
        name: images
        description: Factset Get chart image back in PNG or JPEG formats
        call: chart-generation-service-image.images
        with:
          chart: rest.chart
          ids: rest.ids
          sd: rest.sd
          ed: rest.ed
          width: rest.width
          height: rest.height
          freq: rest.freq
          ccy: rest.ccy
          split: rest.split
          spin: rest.spin
          cal: rest.cal
          title: rest.title
          fontSize: rest.fontSize
          type: rest.type
          gridLines: rest.gridLines
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: chart-generation-service-image-mcp
    port: 9090
    transport: http
    description: MCP adapter for Factset Chart Generation Service — Image. One tool per consumed operation, routed inline
      through this capability's consumes block.
    tools:
    - name: factset-get-chart-image-back
      description: Factset Get chart image back in PNG or JPEG formats
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: chart-generation-service-image.images
      with:
        chart: tools.chart
        ids: tools.ids
        sd: tools.sd
        ed: tools.ed
        width: tools.width
        height: tools.height
        freq: tools.freq
        ccy: tools.ccy
        split: tools.split
        spin: tools.spin
        cal: tools.cal
        title: tools.title
        fontSize: tools.fontSize
        type: tools.type
        gridLines: tools.gridLines
      outputParameters:
      - type: object
        mapping: $.