helicone-api — PI

naftiko: 1.0.0-alpha2
info:
  label: helicone-api — PI
  description: 'helicone-api — PI. 6 operations. Lead operation: PI. Self-contained Naftiko capability covering one Helicone
    business surface.'
  tags:
  - Helicone
  - PI
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    HELICONE_API_KEY: HELICONE_API_KEY
capability:
  consumes:
  - type: http
    namespace: helicone-pi
    baseUri: https://api.helicone.ai
    description: helicone-api — PI business capability. Self-contained, no shared references.
    resources:
    - name: v1-pi-costs-over-time-query
      path: /v1/pi/costs-over-time/query
      operations:
      - name: getcostsovertime
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-pi-org-name-query
      path: /v1/pi/org-name/query
      operations:
      - name: getorgname
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-pi-session
      path: /v1/pi/session
      operations:
      - name: addsession
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-pi-total-costs
      path: /v1/pi/total-costs
      operations:
      - name: gettotalcosts
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-pi-total_requests
      path: /v1/pi/total_requests
      operations:
      - name: pigettotalrequests
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-public-pi-get-api-key
      path: /v1/public/pi/get-api-key
      operations:
      - name: getapikey
        method: POST
        description: ''
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.HELICONE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: helicone-pi-rest
    port: 8080
    description: REST adapter for helicone-api — PI. One Spectral-compliant resource per consumed operation, prefixed with
      /v1.
    resources:
    - path: /v1/v1/pi/costs-over-time/query
      name: v1-pi-costs-over-time-query
      description: REST surface for v1-pi-costs-over-time-query.
      operations:
      - method: POST
        name: getcostsovertime
        description: getcostsovertime
        call: helicone-pi.getcostsovertime
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/pi/org-name/query
      name: v1-pi-org-name-query
      description: REST surface for v1-pi-org-name-query.
      operations:
      - method: POST
        name: getorgname
        description: getorgname
        call: helicone-pi.getorgname
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/pi/session
      name: v1-pi-session
      description: REST surface for v1-pi-session.
      operations:
      - method: POST
        name: addsession
        description: addsession
        call: helicone-pi.addsession
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/pi/total-costs
      name: v1-pi-total-costs
      description: REST surface for v1-pi-total-costs.
      operations:
      - method: POST
        name: gettotalcosts
        description: gettotalcosts
        call: helicone-pi.gettotalcosts
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/pi/total-requests
      name: v1-pi-total-requests
      description: REST surface for v1-pi-total_requests.
      operations:
      - method: POST
        name: pigettotalrequests
        description: pigettotalrequests
        call: helicone-pi.pigettotalrequests
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/public/pi/get-api-key
      name: v1-public-pi-get-api-key
      description: REST surface for v1-public-pi-get-api-key.
      operations:
      - method: POST
        name: getapikey
        description: getapikey
        call: helicone-pi.getapikey
        with:
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: helicone-pi-mcp
    port: 9090
    transport: http
    description: MCP adapter for helicone-api — PI. One tool per consumed operation, routed inline through this capability's
      consumes block.
    tools:
    - name: getcostsovertime
      description: getcostsovertime
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.getcostsovertime
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: getorgname
      description: getorgname
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.getorgname
      outputParameters:
      - type: object
        mapping: $.
    - name: addsession
      description: addsession
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.addsession
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: gettotalcosts
      description: gettotalcosts
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.gettotalcosts
      outputParameters:
      - type: object
        mapping: $.
    - name: pigettotalrequests
      description: pigettotalrequests
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.pigettotalrequests
      outputParameters:
      - type: object
        mapping: $.
    - name: getapikey
      description: getapikey
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: helicone-pi.getapikey
      with:
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.