CAST AI Kubernetes Cost Optimization API — Cost Reports

naftiko: 1.0.0-alpha2
info:
  label: CAST AI Kubernetes Cost Optimization API — Cost Reports
  description: 'CAST AI Kubernetes Cost Optimization API — Cost Reports. 5 operations. Lead operation: CAST AI Get cluster
    efficiency. Self-contained Naftiko capability covering one Cast Ai business surface.'
  tags:
  - Cast Ai
  - Cost Reports
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CAST_AI_API_KEY: CAST_AI_API_KEY
capability:
  consumes:
  - type: http
    namespace: kubernetes-cost-optimization-cost-reports
    baseUri: https://api.cast.ai/v1
    description: CAST AI Kubernetes Cost Optimization API — Cost Reports business capability. Self-contained, no shared references.
    resources:
    - name: cost-reports-clusters-clusterId-efficiency
      path: /cost-reports/clusters/{clusterId}/efficiency
      operations:
      - name: costreportsapigetclusterefficiency
        method: GET
        description: CAST AI Get cluster efficiency
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-allocation-groups
      path: /metrics/allocation-groups
      operations:
      - name: metricsapigetallocationgroupmetrics
        method: GET
        description: CAST AI Get allocation group metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-nodes
      path: /metrics/nodes
      operations:
      - name: metricsapigetnodemetrics
        method: GET
        description: CAST AI Get node metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-prom
      path: /metrics/prom
      operations:
      - name: metricsapigetclustermetrics
        method: GET
        description: CAST AI Get cluster metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: metrics-workloads
      path: /metrics/workloads
      operations:
      - name: metricsapigetworkloadmetrics
        method: GET
        description: CAST AI Get workload metrics
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.CAST_AI_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: kubernetes-cost-optimization-cost-reports-rest
    port: 8080
    description: REST adapter for CAST AI Kubernetes Cost Optimization API — Cost Reports. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/cost-reports/clusters/{clusterid}/efficiency
      name: cost-reports-clusters-clusterid-efficiency
      description: REST surface for cost-reports-clusters-clusterId-efficiency.
      operations:
      - method: GET
        name: costreportsapigetclusterefficiency
        description: CAST AI Get cluster efficiency
        call: kubernetes-cost-optimization-cost-reports.costreportsapigetclusterefficiency
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/allocation-groups
      name: metrics-allocation-groups
      description: REST surface for metrics-allocation-groups.
      operations:
      - method: GET
        name: metricsapigetallocationgroupmetrics
        description: CAST AI Get allocation group metrics
        call: kubernetes-cost-optimization-cost-reports.metricsapigetallocationgroupmetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/nodes
      name: metrics-nodes
      description: REST surface for metrics-nodes.
      operations:
      - method: GET
        name: metricsapigetnodemetrics
        description: CAST AI Get node metrics
        call: kubernetes-cost-optimization-cost-reports.metricsapigetnodemetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/prom
      name: metrics-prom
      description: REST surface for metrics-prom.
      operations:
      - method: GET
        name: metricsapigetclustermetrics
        description: CAST AI Get cluster metrics
        call: kubernetes-cost-optimization-cost-reports.metricsapigetclustermetrics
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/metrics/workloads
      name: metrics-workloads
      description: REST surface for metrics-workloads.
      operations:
      - method: GET
        name: metricsapigetworkloadmetrics
        description: CAST AI Get workload metrics
        call: kubernetes-cost-optimization-cost-reports.metricsapigetworkloadmetrics
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: kubernetes-cost-optimization-cost-reports-mcp
    port: 9090
    transport: http
    description: MCP adapter for CAST AI Kubernetes Cost Optimization API — Cost Reports. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: cast-ai-get-cluster-efficiency
      description: CAST AI Get cluster efficiency
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kubernetes-cost-optimization-cost-reports.costreportsapigetclusterefficiency
      outputParameters:
      - type: object
        mapping: $.
    - name: cast-ai-get-allocation-group
      description: CAST AI Get allocation group metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kubernetes-cost-optimization-cost-reports.metricsapigetallocationgroupmetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: cast-ai-get-node-metrics
      description: CAST AI Get node metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kubernetes-cost-optimization-cost-reports.metricsapigetnodemetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: cast-ai-get-cluster-metrics
      description: CAST AI Get cluster metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kubernetes-cost-optimization-cost-reports.metricsapigetclustermetrics
      outputParameters:
      - type: object
        mapping: $.
    - name: cast-ai-get-workload-metrics
      description: CAST AI Get workload metrics
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: kubernetes-cost-optimization-cost-reports.metricsapigetworkloadmetrics
      outputParameters:
      - type: object
        mapping: $.