AmeriHealth Caritas · Capability

AmeriHealth Caritas Provider Directory FHIR

Naftiko capability wrapping the AmeriHealth Caritas Provider Directory FHIR R4 API. No authentication required. Exposes Practitioner, PractitionerRole, Organization, OrganizationAffiliation, Location, and InsurancePlan search and read operations as both a REST adapter and an MCP tool surface.

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

The capability includes 7 read-only operations. Lead operation: Search Practitioner resources. Can be deployed as a REST endpoint, MCP tool, or Agent Skill via Naftiko.

Tagged areas include AmeriHealth Caritas, Provider Directory, FHIR, and Public.

Run with Naftiko AmeriHealth CaritasProvider DirectoryFHIRPublic

What You Can Do

GET
Searchpractitioners — Search Practitioner
/v1/practitioners
GET
Readpractitioner — Read Practitioner
/v1/practitioner
GET
Searchpractitionerroles — Search PractitionerRole
/v1/practitioner-roles
GET
Searchorganizations — Search Organization
/v1/organizations
GET
Searchorganizationaffiliations — Search OrganizationAffiliation
/v1/organization-affiliations
GET
Searchlocations — Search Location
/v1/locations
GET
Searchinsuranceplans — Search InsurancePlan
/v1/insurance-plans

MCP Tools

search-practitioner

Search Practitioner resources

read-only idempotent
read-practitioner

Read Practitioner by id

read-only idempotent
search-practitioner-role

Search PractitionerRole resources

read-only idempotent
search-organization

Search Organization resources

read-only idempotent
search-organization-affiliation

Search OrganizationAffiliation

read-only idempotent
search-location

Search Location resources

read-only idempotent
search-insurance-plan

Search InsurancePlan resources

read-only idempotent

Capability Spec

amerihealth-caritas-provider-directory.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: AmeriHealth Caritas Provider Directory FHIR
  description: >-
    Naftiko capability wrapping the AmeriHealth Caritas Provider
    Directory FHIR R4 API. No authentication required. Exposes
    Practitioner, PractitionerRole, Organization,
    OrganizationAffiliation, Location, and InsurancePlan search and
    read operations as both a REST adapter and an MCP tool surface.
  tags:
    - AmeriHealth Caritas
    - Provider Directory
    - FHIR
    - Public
  created: '2026-05-23'
  modified: '2026-05-23'
binds: []
capability:
  consumes:
    - type: http
      namespace: ahc-provider-directory
      baseUri: https://api-ext.amerihealthcaritas.com/1200/provider-api
      description: >-
        AmeriHealth Caritas Provider Directory FHIR R4 endpoint. Default
        plan code is 1200; substitute as needed (0100, 0500, 0900,
        1200, 2100, 2400, 2600).
      resources:
        - name: Practitioner
          path: /Practitioner
          operations:
            - name: searchPractitioner
              method: GET
              description: Search Practitioner resources
              outputRawFormat: json
              inputParameters:
                - name: name
                  in: query
                  type: string
                  required: false
                - name: specialty
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
            - name: readPractitioner
              method: GET
              description: Read a Practitioner by id
              outputRawFormat: json
              inputParameters:
                - name: id
                  in: path
                  type: string
                  required: true
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: PractitionerRole
          path: /PractitionerRole
          operations:
            - name: searchPractitionerRole
              method: GET
              description: Search PractitionerRole resources
              outputRawFormat: json
              inputParameters:
                - name: practitioner
                  in: query
                  type: string
                  required: false
                - name: organization
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Organization
          path: /Organization
          operations:
            - name: searchOrganization
              method: GET
              description: Search Organization resources
              outputRawFormat: json
              inputParameters:
                - name: name
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: OrganizationAffiliation
          path: /OrganizationAffiliation
          operations:
            - name: searchOrganizationAffiliation
              method: GET
              description: Search OrganizationAffiliation
              outputRawFormat: json
              inputParameters:
                - name: organization
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: Location
          path: /Location
          operations:
            - name: searchLocation
              method: GET
              description: Search Location resources
              outputRawFormat: json
              inputParameters:
                - name: address-city
                  in: query
                  type: string
                  required: false
                - name: address-state
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: InsurancePlan
          path: /InsurancePlan
          operations:
            - name: searchInsurancePlan
              method: GET
              description: Search InsurancePlan resources
              outputRawFormat: json
              inputParameters:
                - name: name
                  in: query
                  type: string
                  required: false
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: none
  exposes:
    - type: rest
      namespace: ahc-provider-directory-rest
      port: 8080
      description: REST adapter for Provider Directory.
      resources:
        - path: /v1/practitioners
          name: practitioners
          description: Search Practitioner resources
          operations:
            - method: GET
              name: searchPractitioners
              description: Search Practitioner
              call: ahc-provider-directory.searchPractitioner
              with:
                name: rest.name
                specialty: rest.specialty
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/practitioner
          name: practitioner
          description: Read Practitioner by id
          operations:
            - method: GET
              name: readPractitioner
              description: Read Practitioner
              call: ahc-provider-directory.readPractitioner
              with:
                id: rest.id
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/practitioner-roles
          name: practitioner-roles
          description: Search PractitionerRole resources
          operations:
            - method: GET
              name: searchPractitionerRoles
              description: Search PractitionerRole
              call: ahc-provider-directory.searchPractitionerRole
              with:
                practitioner: rest.practitioner
                organization: rest.organization
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/organizations
          name: organizations
          description: Search Organization resources
          operations:
            - method: GET
              name: searchOrganizations
              description: Search Organization
              call: ahc-provider-directory.searchOrganization
              with:
                name: rest.name
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/organization-affiliations
          name: organization-affiliations
          description: Search OrganizationAffiliation
          operations:
            - method: GET
              name: searchOrganizationAffiliations
              description: Search OrganizationAffiliation
              call: ahc-provider-directory.searchOrganizationAffiliation
              with:
                organization: rest.organization
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/locations
          name: locations
          description: Search Location resources
          operations:
            - method: GET
              name: searchLocations
              description: Search Location
              call: ahc-provider-directory.searchLocation
              with:
                address-city: rest.address-city
                address-state: rest.address-state
              outputParameters:
                - type: object
                  mapping: $.
        - path: /v1/insurance-plans
          name: insurance-plans
          description: Search InsurancePlan resources
          operations:
            - method: GET
              name: searchInsurancePlans
              description: Search InsurancePlan
              call: ahc-provider-directory.searchInsurancePlan
              with:
                name: rest.name
              outputParameters:
                - type: object
                  mapping: $.
    - type: mcp
      namespace: ahc-provider-directory-mcp
      port: 9090
      transport: http
      description: MCP adapter for Provider Directory.
      tools:
        - name: search-practitioner
          description: Search Practitioner resources
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchPractitioner
          with:
            name: tools.name
            specialty: tools.specialty
        - name: read-practitioner
          description: Read Practitioner by id
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.readPractitioner
          with:
            id: tools.id
        - name: search-practitioner-role
          description: Search PractitionerRole resources
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchPractitionerRole
          with:
            practitioner: tools.practitioner
            organization: tools.organization
        - name: search-organization
          description: Search Organization resources
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchOrganization
          with:
            name: tools.name
        - name: search-organization-affiliation
          description: Search OrganizationAffiliation
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchOrganizationAffiliation
          with:
            organization: tools.organization
        - name: search-location
          description: Search Location resources
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchLocation
          with:
            address-city: tools.address-city
            address-state: tools.address-state
        - name: search-insurance-plan
          description: Search InsurancePlan resources
          hints:
            readOnly: true
            destructive: false
            idempotent: true
          call: ahc-provider-directory.searchInsurancePlan
          with:
            name: tools.name