naftiko: 1.0.0-alpha2
info:
  label: AmeriHealth Caritas Medications & Formulary
  description: >-
    Naftiko capability wrapping AmeriHealth Caritas FHIR medication and
    formulary resources: Medication, MedicationRequest,
    MedicationDispense, MedicationKnowledge, and List. Patient-scope
    medication operations require a SMART bearer token; the formulary
    surface (MedicationKnowledge / List) is documented as a public,
    no-auth API.
  tags:
    - AmeriHealth Caritas
    - Medications
    - Formulary
    - Pharmacy Benefits
    - FHIR
  created: '2026-05-23'
  modified: '2026-05-23'
binds:
  - namespace: env
    keys:
      AHC_PATIENT_BEARER_TOKEN: AHC_PATIENT_BEARER_TOKEN
capability:
  consumes:
    - type: http
      namespace: ahc-medications
      baseUri: https://api-ext.amerihealthcaritas.com/0500/patient-api
      description: AmeriHealth Caritas FHIR medication and formulary surface.
      resources:
        - name: MedicationRequest
          path: /MedicationRequest
          operations:
            - name: searchMedicationRequest
              method: GET
              description: Search MedicationRequest for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: MedicationDispense
          path: /MedicationDispense
          operations:
            - name: searchMedicationDispense
              method: GET
              description: Search MedicationDispense for a patient
              outputRawFormat: json
              inputParameters:
                - name: patient
                  in: query
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: MedicationKnowledge
          path: /MedicationKnowledge
          operations:
            - name: searchMedicationKnowledge
              method: GET
              description: Search MedicationKnowledge (formulary content)
              outputRawFormat: json
              inputParameters:
                - name: code
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: List
          path: /List
          operations:
            - name: searchList
              method: GET
              description: Search List resources, including formulary List entries
              outputRawFormat: json
              inputParameters:
                - name: code
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: bearer
        token: '{{env.AHC_PATIENT_BEARER_TOKEN}}'
  exposes:
    - type: rest
      namespace: ahc-medications-rest
      port: 8080
      description: REST adapter for medications & formulary.
      resources:
        - path: /v1/medication-requests
          name: medication-requests
          description: Search MedicationRequest for a patient
          operations:
            - method: GET
              name: searchMedicationRequests
              description: Search MedicationRequest
              call: ahc-medications.searchMedicationRequest
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/medication-dispenses
          name: medication-dispenses
          description: Search MedicationDispense for a patient
          operations:
            - method: GET
              name: searchMedicationDispenses
              description: Search MedicationDispense
              call: ahc-medications.searchMedicationDispense
              with:
                patient: rest.patient
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/formulary
          name: formulary
          description: Search formulary MedicationKnowledge
          operations:
            - method: GET
              name: searchFormulary
              description: Search MedicationKnowledge
              call: ahc-medications.searchMedicationKnowledge
              with:
                code: rest.code
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/lists
          name: lists
          description: Search List resources (including formulary)
          operations:
            - method: GET
              name: searchLists
              description: Search List
              call: ahc-medications.searchList
              with:
                code: rest.code
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: ahc-medications-mcp
      port: 9090
      transport: http
      description: MCP adapter for medications & formulary.
      tools:
        - name: search-medication-request
          description: Search MedicationRequest for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-medications.searchMedicationRequest
          with:
            patient: tools.patient
        - name: search-medication-dispense
          description: Search MedicationDispense for a patient
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-medications.searchMedicationDispense
          with:
            patient: tools.patient
        - name: search-medication-knowledge
          description: Search MedicationKnowledge (formulary content)
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-medications.searchMedicationKnowledge
          with:
            code: tools.code
        - name: search-list
          description: Search List resources (including formulary)
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-medications.searchList
          with:
            code: tools.code