Profile

`get_user_profile`

Returns the account’s tier, capabilities, connections, patients, region support, and health-record counts.

Field	Meaning
`tier`	`connected` means the patient is signed in. `linked` means an insurance connection for the account holder is ready.
`capabilities`	Readiness for conversations, prescriptions, care actions, pricing, network status, claims, and visits.
`connections`	Linked sources for each patient profile, with an `id`, `patientId`, `source`, and status such as `importing`, `ready`, `failed`, or `expired`.
`patients`	Account-holder and dependent profiles. Use a profile’s `patientId` when an action targets that person.
`healthRecords`	Counts and connection summary only. Call `get_health_records` to read records.
`regionSupported`	Whether the patient’s home state is a region Arlo serves; care uses the patient’s physical location at care time.

Each entry in capabilities has ready: true, or ready: false with needs; some entries also include better. The source labels explain how an input can be supplied:

Source	Supply the input with
`params`	The relevant tool call; pricing plan details use `planHints`
`profile`	`update_patient_info`
`link`	`connect_insurance`
`payPage`	The Stripe page linked from the visit payment gate

capabilities.visit.atPayment lists the identity fields still needed at the payment page. A provider visit needs first name, last name, date of birth, gender, and a home address. The payment page collects missing values; save them in the profile first to avoid entering them there.

Example response

{
    "accountId": "account_example",
    "status": "ONBOARDED",
    "tier": "linked",
    "capabilities": {
        "conversations": { "ready": true },
        "prescriptions": { "ready": true },
        "careRequests": { "ready": true },
        "pricing": { "ready": true, "better": { "plan": ["Example plan"] } },
        "networkStatus": { "ready": true },
        "claims": { "ready": true },
        "visit": { "ready": true, "atPayment": [] }
    },
    "connections": [
        {
            "id": "connection_example",
            "type": "insurance",
            "patientId": "patient_example",
            "source": "Example insurer",
            "status": "ready",
            "linkedAt": "2026-01-01T00:00:00.000Z",
            "lastSyncAt": "2026-01-01T00:00:00.000Z",
            "expiresAt": "2026-12-31T00:00:00.000Z",
            "coverage": {
                "payer": "Example insurer",
                "plan": "Example plan",
                "periodEnd": "2026-12-31"
            }
        }
    ],
    "patients": [
        {
            "patientId": "patient_example",
            "firstName": "Example",
            "lastName": "Patient",
            "displayName": "Example Patient",
            "gender": "Female",
            "phone": "[redacted]",
            "email": "patient@example.com",
            "birthDate": { "year": 1990, "month": 3, "day": 15 },
            "isDefault": true,
            "address": "100 Example St",
            "address2": "",
            "city": "Example City",
            "state": "CA",
            "country": "US",
            "zip": "00000",
            "medications": [{ "title": "Example medication", "description": "Example details" }],
            "conditions": [{ "title": "Example condition", "description": "Example details" }],
            "allergies": [{ "title": "Example allergy", "severity": "low" }]
        }
    ],
    "regionSupported": true,
    "healthRecords": {
        "connected": true,
        "payer": "Example insurer",
        "importedAt": "2026-01-01T00:00:00.000Z",
        "lastSyncedAt": "2026-01-01T00:00:00.000Z",
        "syncStatus": "ready",
        "syncInProgress": false,
        "syncNote": null,
        "hasRecords": true,
        "totalRecords": 2,
        "recordCounts": {
            "coverage": 1,
            "conditions": 0,
            "medications": 1,
            "allergies": 0,
            "immunizations": 0,
            "visits": 0,
            "claims": 0,
            "labs": 0,
            "vitals": 0
        },
        "note": "Example record summary."
    }
}

`update_patient_info`

Updates patient demographics, contact details, or medical history. Fields are optional; use patientId from get_user_profile to target a dependent. Without it, the account’s default patient is updated.

Parameter	Type	Details
`patientId`	string	Patient profile to update
`firstName`, `lastName`, `displayName`	string	Patient name and preferred display name
`birthDate`	object	`year`, `month`, and `day`
`gender`	string	`Female`, `Male`, or `Other`
`phone`	string	US phone number; prescriptions are delivered by SMS
`email`	string	Email address
`address`, `address2`, `city`, `state`, `zip`	string	Home address; `state` is not the care region
`country`	string	`US`
`medications`, `conditions`, `allergies`	array	Medical-history entries
`replaceMedicalHistory`	boolean	Defaults to `false`; when true, stores each supplied medical-history list exactly as provided

Medical-history lists merge by title by default: matching titles are updated, additional titles are appended, and unmentioned entries remain. Set replaceMedicalHistory: true when supplying a complete list. The result includes success, patientId, and updatedFields. Medical-history field names in updatedFields use medication, condition, and allergy.

Example response

{
    "success": true,
    "patientId": "patient_example",
    "updatedFields": ["firstName", "lastName"]
}

Overview

Tools Reference

`get_user_profile`

Example response

`update_patient_info`

Example response

​get_user_profile

​Example response

​update_patient_info

​Example response

`get_user_profile`

Example response

`update_patient_info`

Example response