Suki Info API — Reference

naftiko: 1.0.0-alpha2
info:
  label: Suki Info API — Reference
  description: Read-only catalogs of Suki-curated clinical reference data — specialties, diagnoses, encounter and visit types, LOINC sections, provider roles, medication orders, coding systems, dosage units.
  tags:
    - Suki
    - Info
    - Reference Data
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
  - namespace: env
    keys:
      SUKI_SDP_TOKEN: SUKI_SDP_TOKEN
capability:
  consumes:
    - type: http
      namespace: info-reference
      baseUri: https://sdp.suki-stage.com
      description: Suki Speech Service reference catalogs.
      resources:
        - name: info-specialties
          path: /api/v1/info/specialties
          operations:
            - name: listspecialties
              method: GET
              outputParameters:
                - { name: result, type: object, value: $. }
        - name: info-diagnoses
          path: /api/v1/info/diagnoses
          operations:
            - name: listdiagnoses
              method: GET
              inputParameters:
                - { name: q, in: query, type: string }
                - { name: system, in: query, type: string }
              outputParameters:
                - { name: result, type: object, value: $. }
        - name: info-encounter-types
          path: /api/v1/info/encounter-types
          operations:
            - { name: listencountertypes, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-visit-types
          path: /api/v1/info/visit-types
          operations:
            - { name: listvisittypes, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-loincs
          path: /api/v1/info/loincs
          operations:
            - { name: listloincs, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-provider-roles
          path: /api/v1/info/provider-roles
          operations:
            - { name: listproviderroles, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-medication-orders
          path: /api/v1/info/medication-orders
          operations:
            - { name: listmedicationorders, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-orders-coding-systems
          path: /api/v1/info/orders-coding-systems
          operations:
            - { name: listorderscodingsystems, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
        - name: info-orders-dosage-units
          path: /api/v1/info/orders-dosage-units
          operations:
            - { name: listordersdosageunits, method: GET, outputParameters: [{ name: result, type: object, value: $. }] }
      authentication:
        type: apikey
        key: sdp_suki_token
        value: '{{env.SUKI_SDP_TOKEN}}'
        placement: header
  exposes:
    - type: mcp
      namespace: info-reference-mcp
      port: 9090
      transport: http
      description: MCP adapter for Suki Info reference catalogs.
      tools:
        - { name: suki-info-list-specialties, description: List supported medical specialties, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listspecialties, with: {} }
        - { name: suki-info-list-diagnoses, description: List supported diagnosis codes, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listdiagnoses, with: { q: tools.q, system: tools.system } }
        - { name: suki-info-list-encounter-types, description: List encounter types, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listencountertypes, with: {} }
        - { name: suki-info-list-visit-types, description: List visit types, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listvisittypes, with: {} }
        - { name: suki-info-list-loincs, description: List LOINC note sections, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listloincs, with: {} }
        - { name: suki-info-list-provider-roles, description: List provider roles, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listproviderroles, with: {} }
        - { name: suki-info-list-medication-orders, description: List medication order metadata, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listmedicationorders, with: {} }
        - { name: suki-info-list-orders-coding-systems, description: List medication order coding systems, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listorderscodingsystems, with: {} }
        - { name: suki-info-list-orders-dosage-units, description: List medication order dosage units, hints: { readOnly: true, destructive: false, idempotent: true }, call: info-reference.listordersdosageunits, with: {} }