naftiko: 1.0.0-alpha2
info:
  label: Walgreens Pharmacy and Healthcare
  description: 'Workflow capability combining Walgreens Store Locator and Vaccine Scheduling APIs for pharmacy and healthcare
    applications. Enables end-to-end patient workflows: finding nearby Walgreens pharmacies, checking vaccine eligibility,
    discovering available appointment slots, and booking immunization appointments. Designed for healthcare applications,
    patient portals, and wellness platforms.'
  tags:
  - Walgreens
  - Pharmacy
  - Healthcare
  - Vaccines
  - Immunizations
  - Store Locator
  created: '2026-05-03'
  modified: '2026-05-06'
binds:
- namespace: env
  keys:
    WALGREENS_API_KEY: WALGREENS_API_KEY
    WALGREENS_AFFILIATE_ID: WALGREENS_AFFILIATE_ID
capability:
  consumes:
  - type: http
    namespace: walgreens-store-locator
    baseUri: https://services.walgreens.com
    description: Walgreens store location search and details API
    authentication:
      type: apikey
      key: apiKey
      value: '{{WALGREENS_API_KEY}}'
      placement: body
    resources:
    - name: store-search
      path: /api/stores/search/v2
      description: Search Walgreens stores by location
      operations:
      - name: search-stores
        method: POST
        description: Search for Walgreens stores by geolocation, address, or zip code
        inputParameters:
        - name: lat
          in: body
          type: number
          required: false
          description: Latitude coordinate for search
        - name: lng
          in: body
          type: number
          required: false
          description: Longitude coordinate for search
        - name: address
          in: body
          type: string
          required: false
          description: Street address for search
        - name: zip
          in: body
          type: string
          required: false
          description: Zip code for search
        - name: r
          in: body
          type: integer
          required: true
          description: Search radius in miles
        - name: s
          in: body
          type: integer
          required: true
          description: Items per page
        - name: p
          in: body
          type: integer
          required: true
          description: Page number
        - name: filterOptions
          in: body
          type: array
          required: false
          description: Service filter options
        outputRawFormat: json
        outputParameters:
        - name: results
          type: array
          value: $.results
    - name: store-details
      path: /api/stores/details/v1
      description: Get detailed information for a specific store
      operations:
      - name: get-store-details
        method: POST
        description: Retrieve comprehensive details for a specific Walgreens store
        inputParameters:
        - name: storeNo
          in: body
          type: string
          required: true
          description: Store number to query
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: store-numbers
      path: /api/util/storenumber/v1
      description: Get all store numbers
      operations:
      - name: list-store-numbers
        method: POST
        description: Retrieve complete list of all Walgreens store numbers
        inputParameters:
        - name: act
          in: body
          type: string
          required: true
          description: Always set to storenumber
        outputRawFormat: json
        outputParameters:
        - name: store
          type: array
          value: $.store
  - type: http
    namespace: walgreens-vaccine-scheduling
    baseUri: https://services.walgreens.com
    description: Walgreens vaccine and immunization appointment scheduling API
    authentication:
      type: apikey
      key: apiKey
      value: '{{WALGREENS_API_KEY}}'
      placement: body
    resources:
    - name: eligibility
      path: /api/vaccine/scheduling/eligibility/v1
      description: Check vaccine eligibility by state and date of birth
      operations:
      - name: check-vaccine-eligibility
        method: POST
        description: Determine vaccine eligibility for a patient by state and DOB
        inputParameters:
        - name: state
          in: body
          type: string
          required: true
          description: Two-character US state code
        - name: dob
          in: body
          type: string
          required: true
          description: Patient date of birth in YYYY-MM-DD format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: timeslots
      path: /api/vaccine/scheduling/timeslots/v1
      description: Get available vaccine appointment timeslots
      operations:
      - name: get-vaccine-timeslots
        method: POST
        description: Retrieve available appointment timeslots for vaccines near a location
        inputParameters:
        - name: state
          in: body
          type: string
          required: true
          description: Two-character US state code
        - name: zipCode
          in: body
          type: string
          required: true
          description: Location zip code
        - name: dob
          in: body
          type: string
          required: true
          description: Patient date of birth
        - name: vaccine
          in: body
          type: array
          required: true
          description: Array of vaccine codes to search
        - name: appointmentAvailability
          in: body
          type: object
          required: true
          description: Date range for appointment search
        - name: position
          in: body
          type: object
          required: true
          description: Geographic coordinates for distance sorting
        outputRawFormat: json
        outputParameters:
        - name: locations
          type: array
          value: $.locations
    - name: hold
      path: /api/vaccine/scheduling/hold/v1
      description: Hold a vaccine appointment timeslot
      operations:
      - name: hold-vaccine-appointment
        method: POST
        description: Reserve a specific vaccine appointment timeslot
        inputParameters:
        - name: locationId
          in: body
          type: string
          required: true
          description: Store location identifier
        - name: appointmentDate
          in: body
          type: string
          required: true
          description: ISO format appointment date/time
        - name: slot
          in: body
          type: string
          required: true
          description: Time slot to hold
        - name: channel
          in: body
          type: string
          required: true
          description: Web or Mobile
        - name: vaccines
          in: body
          type: array
          required: true
          description: Vaccine selection objects
        outputRawFormat: json
        outputParameters:
        - name: engagementId
          type: string
          value: $.engagementId
    - name: patient
      path: /api/vaccine/scheduling/patient/v1
      description: Attach patient information to an appointment
      operations:
      - name: attach-patient-to-appointment
        method: POST
        description: Register patient PII for a held vaccine appointment
        inputParameters:
        - name: engagementId
          in: body
          type: string
          required: true
          description: Engagement ID from hold response
        - name: partnerId
          in: body
          type: string
          required: true
          description: Client application name
        - name: firstName
          in: body
          type: string
          required: true
          description: Patient first name
        - name: lastName
          in: body
          type: string
          required: true
          description: Patient last name
        - name: dob
          in: body
          type: string
          required: true
          description: Patient date of birth
        - name: gender
          in: body
          type: string
          required: true
          description: Patient gender
        - name: contact
          in: body
          type: object
          required: true
          description: Patient contact information
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: confirm
      path: /api/vaccine/scheduling/confirm/v1
      description: Confirm a vaccine appointment
      operations:
      - name: confirm-vaccine-appointment
        method: PATCH
        description: Finalize a held vaccine appointment reservation
        inputParameters:
        - name: engagementId
          in: body
          type: string
          required: true
          description: Engagement ID from hold response
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: walgreens-pharmacy-healthcare-api
    description: Unified REST API for Walgreens pharmacy and healthcare workflows.
    resources:
    - path: /v1/stores
      name: stores
      description: Search and find Walgreens pharmacy locations
      operations:
      - method: POST
        name: search-stores
        description: Find nearby Walgreens pharmacy locations by address or coordinates
        call: walgreens-store-locator.search-stores
        outputParameters:
        - type: array
          mapping: $.results
    - path: /v1/stores/{storeNo}
      name: store-detail
      description: Get details for a specific pharmacy location
      operations:
      - method: GET
        name: get-store-details
        description: Get detailed hours and services for a specific Walgreens
        call: walgreens-store-locator.get-store-details
        with:
          storeNo: rest.storeNo
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/store-numbers
      name: store-numbers
      description: List all Walgreens store numbers
      operations:
      - method: GET
        name: list-store-numbers
        description: Get complete list of all Walgreens store numbers
        call: walgreens-store-locator.list-store-numbers
        outputParameters:
        - type: array
          mapping: $.store
    - path: /v1/vaccine-eligibility
      name: vaccine-eligibility
      description: Check patient vaccine eligibility
      operations:
      - method: POST
        name: check-vaccine-eligibility
        description: Determine which vaccines a patient is eligible for
        call: walgreens-vaccine-scheduling.check-vaccine-eligibility
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vaccine-timeslots
      name: vaccine-timeslots
      description: Find available vaccine appointment times
      operations:
      - method: POST
        name: get-vaccine-timeslots
        description: Get available vaccine appointment timeslots near a location
        call: walgreens-vaccine-scheduling.get-vaccine-timeslots
        outputParameters:
        - type: array
          mapping: $.locations
    - path: /v1/vaccine-appointments
      name: vaccine-appointments
      description: Create and manage vaccine appointments
      operations:
      - method: POST
        name: hold-vaccine-appointment
        description: Hold a vaccine appointment timeslot
        call: walgreens-vaccine-scheduling.hold-vaccine-appointment
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vaccine-appointments/{engagementId}/patient
      name: vaccine-appointment-patient
      description: Register patient for vaccine appointment
      operations:
      - method: POST
        name: attach-patient-to-appointment
        description: Register patient information for a held appointment
        call: walgreens-vaccine-scheduling.attach-patient-to-appointment
        with:
          engagementId: rest.engagementId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/vaccine-appointments/{engagementId}/confirm
      name: vaccine-appointment-confirm
      description: Confirm a vaccine appointment
      operations:
      - method: PATCH
        name: confirm-vaccine-appointment
        description: Finalize a vaccine appointment booking
        call: walgreens-vaccine-scheduling.confirm-vaccine-appointment
        with:
          engagementId: rest.engagementId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9080
    namespace: walgreens-pharmacy-healthcare-mcp
    transport: http
    description: MCP server for AI-assisted Walgreens pharmacy and healthcare workflows.
    tools:
    - name: search-walgreens-pharmacies
      description: Find Walgreens pharmacy locations near an address, zip code, or coordinates. Supports filtering by services
        like 24-hour pharmacy, drive-thru, or flu shots.
      hints:
        readOnly: true
        openWorld: true
      call: walgreens-store-locator.search-stores
      with:
        lat: tools.lat
        lng: tools.lng
        address: tools.address
        zip: tools.zip
        r: tools.radius
        s: tools.pageSize
        p: tools.page
        filterOptions: tools.filterOptions
      outputParameters:
      - type: array
        mapping: $.results
    - name: get-pharmacy-details
      description: Get detailed hours, services, and contact information for a specific Walgreens pharmacy
      hints:
        readOnly: true
        openWorld: false
      call: walgreens-store-locator.get-store-details
      with:
        storeNo: tools.storeNo
      outputParameters:
      - type: object
        mapping: $.
    - name: check-vaccine-eligibility
      description: Check which vaccines a patient is eligible for based on their state and date of birth. Returns eligible
        and ineligible vaccine lists with details.
      hints:
        readOnly: true
        openWorld: true
      call: walgreens-vaccine-scheduling.check-vaccine-eligibility
      with:
        state: tools.state
        dob: tools.dob
      outputParameters:
      - type: object
        mapping: $.
    - name: find-vaccine-appointments
      description: Find available vaccine appointment times at Walgreens locations near a specified zip code. Returns locations
        with available dates and time slots.
      hints:
        readOnly: true
        openWorld: true
      call: walgreens-vaccine-scheduling.get-vaccine-timeslots
      with:
        state: tools.state
        zipCode: tools.zipCode
        dob: tools.dob
        vaccine: tools.vaccine
        appointmentAvailability: tools.appointmentAvailability
        position: tools.position
      outputParameters:
      - type: array
        mapping: $.locations
    - name: hold-vaccine-appointment
      description: Reserve a specific vaccine appointment slot at a Walgreens location
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: walgreens-vaccine-scheduling.hold-vaccine-appointment
      with:
        locationId: tools.locationId
        appointmentDate: tools.appointmentDate
        slot: tools.slot
        channel: tools.channel
        vaccines: tools.vaccines
      outputParameters:
      - type: object
        mapping: $.
    - name: confirm-vaccine-appointment
      description: Finalize a held vaccine appointment to complete the booking
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: walgreens-vaccine-scheduling.confirm-vaccine-appointment
      with:
        engagementId: tools.engagementId
      outputParameters:
      - type: object
        mapping: $.