AmeriHealth Caritas · Capability

AmeriHealth Caritas Medications & Formulary

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.

AmeriHealth Caritas Medications & Formulary is a Naftiko capability published by AmeriHealth Caritas, one of 4 capabilities the APIs.io network indexes for this provider. It bundles 4 operations across the GET method.

The capability includes 4 read-only operations. Lead operation: Search MedicationRequest for a patient. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include AmeriHealth Caritas, Medications, Formulary, Pharmacy Benefits, and FHIR.

Run with Naftiko AmeriHealth CaritasMedicationsFormularyPharmacy BenefitsFHIR

What You Can Do

GET
Searchmedicationrequests — Search MedicationRequest
/v1/medication-requests
GET
Searchmedicationdispenses — Search MedicationDispense
/v1/medication-dispenses
GET
Searchformulary — Search MedicationKnowledge
/v1/formulary
GET
Searchlists — Search List
/v1/lists

MCP Tools

search-medication-request

Search MedicationRequest for a patient

read-only idempotent
search-medication-dispense

Search MedicationDispense for a patient

read-only idempotent
search-medication-knowledge

Search MedicationKnowledge (formulary content)

read-only idempotent
search-list

Search List resources (including formulary)

read-only idempotent

Capability Spec

amerihealth-caritas-medications-and-formulary.yaml Raw ↑ 
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