PointClickCare Long-Term Care EHR API — Patients

naftiko: 1.0.0-alpha2
info:
  label: PointClickCare Long-Term Care EHR API — Patients
  description: 'PointClickCare Long-Term Care EHR API — Patients. 2 operations. Lead operation: List residents/patients. Self-contained
    Naftiko capability covering one Pointclickcare business surface.'
  tags:
  - Pointclickcare
  - Patients
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    POINTCLICKCARE_API_KEY: POINTCLICKCARE_API_KEY
capability:
  consumes:
  - type: http
    namespace: ehr-patients
    baseUri: https://api.pointclickcare.com/v2
    description: PointClickCare Long-Term Care EHR API — Patients business capability. Self-contained, no shared references.
    resources:
    - name: patients
      path: /patients
      operations:
      - name: listpatients
        method: GET
        description: List residents/patients
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: facilityId
          in: query
          type: string
          description: Facility identifier
          required: true
        - name: status
          in: query
          type: string
          description: Filter by admission status
        - name: unitId
          in: query
          type: string
          description: Filter by unit/floor
        - name: updatedSince
          in: query
          type: string
          description: Return only records updated after this timestamp
        - name: offset
          in: query
          type: integer
        - name: limit
          in: query
          type: integer
    - name: patients-patientId
      path: /patients/{patientId}
      operations:
      - name: getpatient
        method: GET
        description: Get a resident/patient
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    authentication:
      type: bearer
      token: '{{env.POINTCLICKCARE_API_KEY}}'
  exposes:
  - type: rest
    namespace: ehr-patients-rest
    port: 8080
    description: REST adapter for PointClickCare Long-Term Care EHR API — Patients. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/patients
      name: patients
      description: REST surface for patients.
      operations:
      - method: GET
        name: listpatients
        description: List residents/patients
        call: ehr-patients.listpatients
        with:
          facilityId: rest.facilityId
          status: rest.status
          unitId: rest.unitId
          updatedSince: rest.updatedSince
          offset: rest.offset
          limit: rest.limit
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/patients/{patientid}
      name: patients-patientid
      description: REST surface for patients-patientId.
      operations:
      - method: GET
        name: getpatient
        description: Get a resident/patient
        call: ehr-patients.getpatient
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: ehr-patients-mcp
    port: 9090
    transport: http
    description: MCP adapter for PointClickCare Long-Term Care EHR API — Patients. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: list-residents-patients
      description: List residents/patients
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: ehr-patients.listpatients
      with:
        facilityId: tools.facilityId
        status: tools.status
        unitId: tools.unitId
        updatedSince: tools.updatedSince
        offset: tools.offset
        limit: tools.limit
      outputParameters:
      - type: object
        mapping: $.
    - name: get-resident-patient
      description: Get a resident/patient
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: ehr-patients.getpatient
      outputParameters:
      - type: object
        mapping: $.