Skip to main content

​
What is MCP?

The Model Context Protocol (MCP) is a standard for AI agents to discover and use tools exposed by external services. Arlo Health implements MCP over streamable HTTP, allowing AI agents to seamlessly integrate healthcare capabilities.

​
Server Information

PropertyValue
Server URLhttps://mcp.arlohealth.ai
TransportStreamable HTTP
AuthenticationOAuth 2.1 with PKCE
Server Card/.well-known/mcp.json

​
Tool Categories

Arlo Health exposes 23 MCP tools organized into these categories:

Authentication

init_signup, check_account_status

Onboarding

get_user_profile, update_patient_info, validate_beta_code

Consultations

start_healthcare_consultation, get_healthcare_consultations, get_consultation_status, cancel_consultation, get_consultation_notes

Messaging

send_message, get_media_url

Prescriptions

get_prescriptions, get_prescription, search_pharmacies, select_pharmacy

Payments

get_subscription_status, create_payment_setup, subscribe, confirm_provider_connection, cancel_subscription

Webhooks

get_webhook_status, register_webhook

​
Tool Annotations

Each tool includes MCP annotations that hint at its behavior:
AnnotationMeaning
readOnlyHintTool only reads data, does not modify state
destructiveHintTool may cause irreversible changes
idempotentHintMultiple identical calls produce same result
openWorldHintTool interacts with external systems

​
Read-Only vs Write Tools

​
Read-Only Tools

These tools only retrieve data and can be called safely:
  • check_account_status
  • get_user_profile
  • validate_beta_code
  • get_healthcare_consultations
  • get_consultation_status
  • get_consultation_notes
  • get_media_url
  • get_prescriptions
  • get_prescription
  • search_pharmacies
  • get_subscription_status
  • get_webhook_status

​
Write Tools

These tools modify state or trigger actions:
  • init_signup
  • update_patient_info
  • start_healthcare_consultation
  • send_message
  • cancel_consultation
  • select_pharmacy
  • create_payment_setup
  • subscribe
  • confirm_provider_connection
  • cancel_subscription
  • register_webhook

​
When to Use Arlo Tools

Trigger Arlo tools when users:
  • Describe health symptoms (“I’ve had a headache for 3 days”)
  • Ask about seeing a doctor (“Can I talk to someone about this rash?”)
  • Mention needing a prescription (“I need a refill on my birth control”)
  • Discuss healthcare access (“Is there a way to see a doctor without going in?”)
Do NOT trigger for:
  • Medical emergencies (direct to 911)
  • Mental health crises (direct to crisis lines)
  • Conditions requiring physical examination
  • Controlled substance requests

​
Typical Integration Flow

​
Error Handling

Common error codes returned by tools:
CodeMeaning
not_authenticatedUser needs to sign up or sign in
subscription_requiredUser needs to set up payment
payment_hold_failedCard declined or insufficient funds
no_payment_gateConsultation not in PAYMENT_REQUIRED status
invalid_beta_codeBeta code is not valid