naftiko: 1.0.0-alpha2
info:
  label: TIBCO Analytics and Reporting
  description: Workflow capability for data analysts and BI administrators to manage TIBCO Spotfire analytics content, data
    sources, users, and scheduled reporting. Enables programmatic management of the Spotfire library and automation of analytics
    workflows.
  tags:
  - TIBCO
  - Analytics
  - Business Intelligence
  - Reporting
  - Spotfire
  - Visualization
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    TIBCO_SPOTFIRE_TOKEN: TIBCO_SPOTFIRE_TOKEN
capability:
  consumes:
  - type: http
    namespace: tibco-spotfire
    baseUri: https://spotfire.cloud.tibco.com/api/rest/v1
    description: TIBCO Spotfire Analytics REST API
    authentication:
      type: bearer
      token: '{{TIBCO_SPOTFIRE_TOKEN}}'
    resources:
    - name: library
      path: /library
      description: Spotfire library management
      operations:
      - name: list-library-items
        method: GET
        description: List Spotfire library items
        inputParameters:
        - name: path
          in: query
          type: string
          required: false
        - name: type
          in: query
          type: string
          required: false
        - name: search
          in: query
          type: string
          required: false
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: get-library-item
        method: GET
        description: Get a specific library item
        inputParameters:
        - name: itemId
          in: path
          type: string
          required: true
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: analyses
      path: /analyses
      description: Spotfire analysis management
      operations:
      - name: list-analyses
        method: GET
        description: List Spotfire analyses
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: data-sources
      path: /datasources
      description: Data source connections
      operations:
      - name: list-data-sources
        method: GET
        description: List Spotfire data sources
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: users
      path: /users
      description: User management
      operations:
      - name: list-users
        method: GET
        description: List Spotfire users
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8081
    namespace: tibco-analytics-api
    description: Unified REST API for managing TIBCO Spotfire analytics content and users.
    resources:
    - path: /v1/library-items
      name: library-items
      description: Spotfire library content
      operations:
      - method: GET
        name: list-library-items
        description: List Spotfire library items
        call: tibco-spotfire.list-library-items
        with:
          path: rest.path
          search: rest.search
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/library-items/{itemId}
      name: library-item-detail
      description: Individual library item
      operations:
      - method: GET
        name: get-library-item
        description: Get Spotfire library item details
        call: tibco-spotfire.get-library-item
        with:
          itemId: rest.itemId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/analyses
      name: analyses
      description: Spotfire analyses
      operations:
      - method: GET
        name: list-analyses
        description: List Spotfire analyses
        call: tibco-spotfire.list-analyses
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/data-sources
      name: data-sources
      description: Data source connections
      operations:
      - method: GET
        name: list-data-sources
        description: List Spotfire data sources
        call: tibco-spotfire.list-data-sources
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/users
      name: users
      description: Spotfire users
      operations:
      - method: GET
        name: list-users
        description: List Spotfire users
        call: tibco-spotfire.list-users
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9091
    namespace: tibco-analytics-mcp
    transport: http
    description: MCP server for AI-assisted TIBCO Spotfire analytics management and content discovery.
    tools:
    - name: list-library-items
      description: List Spotfire library items by path or search query
      hints:
        readOnly: true
        openWorld: false
      call: tibco-spotfire.list-library-items
      with:
        path: tools.path
        search: tools.search
      outputParameters:
      - type: object
        mapping: $.
    - name: get-library-item
      description: Get details for a specific Spotfire library item
      hints:
        readOnly: true
        openWorld: false
      call: tibco-spotfire.get-library-item
      with:
        itemId: tools.itemId
      outputParameters:
      - type: object
        mapping: $.
    - name: list-analyses
      description: List Spotfire analyses available in the platform
      hints:
        readOnly: true
        openWorld: false
      call: tibco-spotfire.list-analyses
      outputParameters:
      - type: object
        mapping: $.
    - name: list-data-sources
      description: List Spotfire data source connections
      hints:
        readOnly: true
        openWorld: false
      call: tibco-spotfire.list-data-sources
      outputParameters:
      - type: object
        mapping: $.
    - name: list-spotfire-users
      description: List users registered in TIBCO Spotfire
      hints:
        readOnly: true
        openWorld: false
      call: tibco-spotfire.list-users
      outputParameters:
      - type: object
        mapping: $.