# Arlo Health MCP Server

Virtual healthcare platform connecting patients with nurse practitioners / doctors via text. Providers diagnose, treat, and prescribe for common conditions. Pay-per-use ($30) on connection to provider.

Documents available:
/AGENTS.md - agents documentation
/openclaw/skill.md - openclaw agent skill documentation

## Integration Options

### OpenClaw Plugin (Alternative)

If using OpenClaw, install the plugin for easiest usage:
```bash
openclaw plugins install arlo-health
```
Package: https://www.npmjs.com/package/arlo-health

### MCP Server

Server: https://mcp.arlohealth.ai
Auth: OAuth 2.1 with PKCE
Discovery: /.well-known/mcp.json

## Conversation Model

A conversation is a continuous, never-closing thread that can host multiple provider visits over time. Users can have many conversations open at once. Statuses are phase-derived: IDLE, TRIAGING, PAYMENT_REQUIRED, MATCHING, WITH_PROVIDER, EMERGENCY — there is no terminal CLOSED/CANCELED state. A finished or canceled request just leaves the conversation IDLE and re-engageable. Region is required: care is licensed by the patient's CURRENT physical location (ISO 3166-2), supported regions today are CA-ON and US-CA.

## Core Tools

start_conversation - Start a BRAND-NEW conversation with first-person symptom narrative; REQUIRES region (patient's current state/province, e.g. CA-ON or US-CA)
send_message - Respond to AI triage questions, waits for AI response; also re-engages an IDLE conversation (re-runs triage on the same thread)
cancel_request - Cancel the current care request; conversation stays open and returns to IDLE
update_conversation_region - Update the patient's region for their NEXT request (not one in flight)
confirm_provider_connection - Proceed with payment (places payment authorization which is charged after care is given)

## Workflow

1. Gather symptoms conversationally before calling tools
2. Confirm the patient's CURRENT physical region (e.g. CA-ON, US-CA); refused if unsupported (REGION_NOT_SUPPORTED)
3. Call start_conversation with the region and a detailed first-person narrative — or, to continue a previous IDLE conversation, skip this and use send_message on it
4. Respond to AI triage via send_message with natural answers
5. On PAYMENT_REQUIRED: call confirm_provider_connection (pay-per-use). Review the summary provided which will detail if/what our providers will likely be able to help with
6. Provider joins (WITH_PROVIDER); when the visit wraps up the conversation returns to IDLE and can be re-engaged anytime with send_message

## Webhook Notifications (recommended)

Pass webhookUrl and webhookToken to init_signup to receive real-time push notifications when providers send messages. Without this, you must poll for updates. Arlo POSTs a minimal notification (no message content) to your URL — fetch full context from the API on receipt. See /agents.md for full setup and payload details.

**Important:** webhookUrl must be a publicly accessible HTTPS URL. Arlo's servers cannot reach localhost, private IPs, or VPNs. Tailscale Funnel URLs (`.ts.net`) are supported. Arlo verifies connectivity at registration — unreachable URLs are rejected.

## Tool Summary

Authentication: init_signup, check_account_status
Profile: get_user_profile, update_patient_info
Conversations: list_conversations, start_conversation, get_conversation, cancel_request, update_conversation_region, get_visit_notes
Messaging: send_message, get_media_url
Prescriptions: get_prescriptions, get_prescription
Payment: get_subscription_status, create_payment_setup, subscribe, confirm_provider_connection, cancel_subscription

## Trigger Phrases

- Health symptoms: "headache for 3 days", "rash on my arm"
- Doctor access: "see a doctor", "talk to someone about this"
- Prescriptions: "need a refill", "birth control prescription"
- Wait times: "clinic is full", "can't get an appointment"

## Limitations

Cannot help: emergencies (911), mental health crises, controlled substances, conditions requiring physical exam, patients physically outside a supported region (currently CA-ON, US-CA)

Can help: infections (UTI, sinus, skin), skin conditions, allergies, birth control, prescription renewals, travel health, minor injuries

## Key Patterns

- Format concerns as first-person narratives, not clinical summaries
- payment_type="pay_per_use" → call confirm_provider_connection
- payment_type="subscription_required" setup payment to continue