Servers Playground How we check Add a server Log in

Chia Health MCP Server

Working · 2.9 s

health.chia/chia-mcpv1.0.0 Domain verified

Licensed US telehealth — GLP-1 medications, intake, consents, Stripe ACP. HIPAA-compliant, 30 tools.

Health & Science

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.chia.health/

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

auth_check_payment Read-only

Check if the patient has completed payment and upgrade the token to full scope. Call this after sharing the checkout payment link with the patient. Poll every 10-15 seconds. When payment is detected, the token is automatically upgraded to full scope, unlocking portal tools (care plan, refills, messaging, weight logs, etc.). Requires the guest token from auth_verify_otp as bearer_token.

bearer_tokenstring

Guest token from auth_verify_otp

Chia Health MCP Server MCP server | mcptry

Tools (34)

auth_check_payment

read-only

Argument	Type	Description
bearer_token	string	Guest token from auth_verify_otp

Input schema (JSON)

{
  "type": "object",
  "title": "check_paymentArguments",
  "properties": {
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Guest token from auth_verify_otp"
    }
  }
}

auth_resend_otp

Resend the verification code to the patient's email. Use this if the original code expired (5-minute window) or was not received. Requires the session_id from auth_start — no email needed.

destructive

Argument	Type	Description
session_id*	string	Session ID from auth_start

Input schema (JSON)

{
  "type": "object",
  "title": "resend_otpArguments",
  "required": [
    "session_id"
  ],
  "properties": {
    "session_id": {
      "type": "string",
      "title": "Session Id",
      "description": "Session ID from auth_start"
    }
  }
}

auth_start

Start a patient session by providing their contact information. Sends a 6-digit verification code to the patient's email. Returns a session_id (NOT a token). The session_id is used with auth_verify_otp to prove email ownership and get a bearer token. The code is in the email subject line: 'Chia Health: Your code is XXXXXX'. If you have access to the patient's email (e.g. Gmail MCP), search for this subject. No authentication required. Call this when the patient is ready to proceed with their medical intake — after browsing medications and checking eligibility.

destructive

Argument	Type	Description
email*	string	Patient's email address
phone*	string	Patient's phone number (US format)
last_name	string	Patient's last name
first_name*	string	Patient's first name

Input schema (JSON)

{
  "type": "object",
  "title": "start_sessionArguments",
  "required": [
    "email",
    "phone",
    "first_name"
  ],
  "properties": {
    "email": {
      "type": "string",
      "title": "Email",
      "description": "Patient's email address"
    },
    "phone": {
      "type": "string",
      "title": "Phone",
      "description": "Patient's phone number (US format)"
    },
    "last_name": {
      "type": "string",
      "title": "Last Name",
      "default": "",
      "description": "Patient's last name"
    },
    "first_name": {
      "type": "string",
      "title": "First Name",
      "description": "Patient's first name"
    }
  }
}

auth_verify_otp

Verify the 6-digit code sent to the patient's email. Returns a guest-scope bearer token for intake, consent, order, and checkout tools. Requires the session_id from auth_start — no email needed. After checkout and payment, call auth_check_payment to upgrade the token to full scope for portal access.

destructive

Argument	Type	Description
code*	string	6-digit verification code from the email
session_id*	string	Session ID from auth_start

Input schema (JSON)

{
  "type": "object",
  "title": "verify_otpArguments",
  "required": [
    "session_id",
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "title": "Code",
      "description": "6-digit verification code from the email"
    },
    "session_id": {
      "type": "string",
      "title": "Session Id",
      "description": "Session ID from auth_start"
    }
  }
}

checkout_cancel

Cancel an in-progress checkout session. Releases any held inventory and cancels the associated Stripe PaymentIntent if not yet captured. Requires authentication.

destructive

Argument	Type	Description
checkout_id*	string	Checkout session ID to cancel
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "cancel_checkoutArguments",
  "required": [
    "checkout_id"
  ],
  "properties": {
    "checkout_id": {
      "type": "string",
      "title": "Checkout Id",
      "description": "Checkout session ID to cancel"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

checkout_complete

Complete payment using Stripe ACP (Shared Payment Token). Only use this if your platform supports Stripe Agentic Commerce Protocol and can provision an SPT. If your platform does NOT support ACP, use the `payment_url` from checkout_create instead, then poll checkout_status. Requires authentication.

destructive

Argument	Type	Description
checkout_id*	string	Checkout session ID to complete payment for
bearer_token	string	Authentication token for the patient session
shared_payment_token*	string	Stripe ACP Shared Payment Token (SPT) provisioned by the client platform

Input schema (JSON)

{
  "type": "object",
  "title": "complete_checkoutArguments",
  "required": [
    "checkout_id",
    "shared_payment_token"
  ],
  "properties": {
    "checkout_id": {
      "type": "string",
      "title": "Checkout Id",
      "description": "Checkout session ID to complete payment for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    },
    "shared_payment_token": {
      "type": "string",
      "title": "Shared Payment Token",
      "description": "Stripe ACP Shared Payment Token (SPT) provisioned by the client platform"
    }
  }
}

checkout_create

Initiate a checkout session for a medication order. Returns checkout details including line items, total, and payment options. TWO PAYMENT PATHS are supported: 1. **Stripe ACP (preferred)**: If your platform supports Stripe Agentic Commerce Protocol, provision a Shared Payment Token (SPT) and call checkout_complete to pay instantly. 2. **Payment link (fallback)**: If ACP/SPT is not available, present the returned `payment_url` to the patient. This is a Stripe-hosted checkout page where the patient can enter their card and pay directly. After sending the link, call checkout_status to poll for payment completion. Requires authentication.

destructive

Argument	Type	Description
order_id*	string	Order ID to create checkout for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "create_checkoutArguments",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID to create checkout for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

checkout_status

Check the payment status of a checkout session. Use this to poll for completion after sending the patient a payment link (the `payment_url` from checkout_create). When the patient pays via the link, this tool detects the payment, triggers order fulfillment, and returns the confirmation. Poll every 5-10 seconds while waiting. Requires authentication.

read-only

Argument	Type	Description
checkout_id*	string	Checkout session ID to check payment status for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_checkout_statusArguments",
  "required": [
    "checkout_id"
  ],
  "properties": {
    "checkout_id": {
      "type": "string",
      "title": "Checkout Id",
      "description": "Checkout session ID to check payment status for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

checkout_update

Update an existing checkout session. Can modify shipping method, apply promo codes, or update customer details before payment is completed. Requires authentication.

destructive

Argument	Type	Description
updates*	object	Updates to apply: shipping method, promo code, or customer details
checkout_id*	string	Checkout session ID to update
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "update_checkoutArguments",
  "required": [
    "checkout_id",
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "object",
      "title": "Updates",
      "description": "Updates to apply: shipping method, promo code, or customer details",
      "additionalProperties": true
    },
    "checkout_id": {
      "type": "string",
      "title": "Checkout Id",
      "description": "Checkout session ID to update"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

consent_list

Get the list of all consent documents a patient must accept before ordering medication. Returns consent IDs, titles, summaries, and order of presentation. Required consents include: telehealth informed consent, compounded medication treatment consent, pharmacy authorization, HIPAA notice of privacy practices, and AI-assisted intake disclosure. Each consent must be fetched individually via consent_text and confirmed by the patient before proceeding. Requires authentication.

read-only

Argument	Type	Description
intake_id*	string	Intake ID to get required consents for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_required_consentsArguments",
  "required": [
    "intake_id"
  ],
  "properties": {
    "intake_id": {
      "type": "string",
      "title": "Intake Id",
      "description": "Intake ID to get required consents for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

consent_status

Check whether all required consents are complete for a patient intake. Returns status of each consent and whether the patient can proceed to ordering. This is a gate — order_create will reject if consents are incomplete. Requires authentication.

read-only

Argument	Type	Description
intake_id*	string	Intake ID to check consent completion for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_consent_statusArguments",
  "required": [
    "intake_id"
  ],
  "properties": {
    "intake_id": {
      "type": "string",
      "title": "Intake Id",
      "description": "Intake ID to check consent completion for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

consent_submit

Record a patient's consent confirmation for a specific consent document. The agent must have already presented the full consent text (from consent_text) to the patient and received explicit confirmation. Required parameters: intake_id, consent_id, the patient's exact confirmation text (e.g. 'I agree'), consent method ('ai_agent_conversational'), the AI platform name ('chatgpt', 'claude', 'gemini'), and a session/conversation ID for audit trail. Returns a consent record with timestamp, audit trail details, and the list of remaining consents still needed. All consent records are retained for 10 years per HIPAA requirements. Requires authentication.

destructive

Argument	Type	Description
intake_id*	string	Intake ID this consent belongs to
timestamp	string	ISO 8601 timestamp of consent confirmation
consent_id*	string	Consent document ID being confirmed
bearer_token	string	Authentication token for the patient session
agent_platform	string	AI platform name: 'chatgpt', 'claude', or 'gemini'
consent_method	string	Method of consent collection
agent_session_id

consent_text

Fetch the full text of a specific consent document for patient review. Returns the complete consent document split into titled sections that the agent MUST present to the patient verbatim in the conversation — do not summarize or paraphrase. Includes: consent version number, effective date, section headings and body text, a confirmation prompt the patient should agree to, and withdrawal instructions. Available consent types: telehealth informed consent, compounded medication treatment consent, pharmacy authorization, HIPAA notice of privacy practices, and AI-assisted intake disclosure. The patient must explicitly confirm each consent before the agent can call consent_submit. Requires authentication.

read-only

Argument	Type	Description
consent_id*	string	Consent document ID from consent_list
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_consent_textArguments",
  "required": [
    "consent_id"
  ],
  "properties": {
    "consent_id": {
      "type": "string",
      "title": "Consent Id",
      "description": "Consent document ID from consent_list"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

eligibility_check

Pre-screen a patient's basic eligibility for telehealth prescription services. Required: age (18+) and state (where the patient resides). Optional: BMI (20+ required for GLP-1 / weight-loss products), biological sex, pregnancy status, and diagnosed conditions. Only pass parameters that apply to this patient. `pregnancy_status` applies ONLY when biological sex is female — omit it entirely for males. Don't invent values to satisfy the schema; if you don't know, leave the parameter out and the server will return what is or isn't checkable. If you already know the patient's age, sex, state, height/weight from prior conversation context, you may pre-fill — but read the values back to the patient and get explicit confirmation before calling this tool. Returns eligibility status, available medications, and any disqualifying reasons (MTC/MEN2 history, pregnancy, out-of-coverage state, etc.).

read-only

Argument	Type	Description
age*	integer	Patient's age in years (must be 18+). Confirm with the patient before submitting.
bmi	any	Patient's Body Mass Index. Required for GLP-1 / weight-loss eligibility (must be 20+). Omit for longevity products. Compute from confirmed height + weight; don't ask the patient to compute it themselves.
sex	any	Patient's biological sex. Pass 'female' when you'll also pass `pregnancy_status` (so the server knows pregnancy screening was considered). Pass 'male' to make it explicit that pregnancy screening doesn't apply. Omit if the patient hasn't been asked yet and the product doesn't require sex for eligibility.
state*	string

intake_questions

Get the medical intake questionnaire for the chosen medication(s). The questionnaire is product-aware: GLP-1 / weight-loss medications return weight-loss goals, GLP-1 history, and MTC/MEN2 screening; NAD+ and other longevity peptides return energy/sleep/stress/cognitive/delivery-method questions instead. If the patient wants more than one medication, pass the additional slugs in `additional_medications` — the server returns the UNION of section sets deduped by section key, so you ask each shared question exactly once. ## How to present this to the patient 1. PROGRESSIVE DISCLOSURE: walk through ONE section at a time. Wait for the patient's reply before moving to the next section. Do not paste the whole questionnaire in a single message. 2. HONOR CONDITIONALS: each section and each question may carry a `conditional_on` predicate (e.g. `{sex_assigned_at_birth: Female}` on the Pregnancy section). SKIP any section/question whose predicate isn't satisfied. Don't ask males about pregnancy or perimenopause. 3. QUIZ FORMAT: present every `select` / `multi_select` question as a short pick-list using the `options` array verbatim. The patient should be able to reply with a single choice, not a sentence. Reserve free text for `*_details` follow-ups. 4. EASY FIRST: order sections from low-friction (goals, lifestyle, preferences) to high-friction (clinical history, MTC/MEN2, prior therapies). The provider sees all answers regardless of order asked. 5. USE-AND-VERIFY: if you know answers from prior conversation context, pre-fill them in your draft, but read them back to the patient and get explicit OK before calling `intake_submit`. Never silently submit assumed values. Returns two phases: (1) pre_checkout — eligibility / screening questions, collected and submitted BEFORE payment; (2) post_checkout — detailed clinical history, collected and submitted AFTER payment. Do not submit post_checkout answers before the patient has paid. A licensed US healthcare provider reviews both phases and makes all prescribing decisions.

read-only

Argument	Type	Description
client_ip	string

intake_status

Check the current status of a previously submitted intake questionnaire. Returns whether the intake is under review, approved, or denied by a licensed healthcare provider. Use this to poll for provider review completion before proceeding to order placement. Requires authentication.

read-only

Argument	Type	Description
intake_id*	string	Intake ID returned from intake_submit
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_intake_statusArguments",
  "required": [
    "intake_id"
  ],
  "properties": {
    "intake_id": {
      "type": "string",
      "title": "Intake Id",
      "description": "Intake ID returned from intake_submit"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

intake_submit

Submit a completed medical intake questionnaire for provider review. All fields from intake_questions must be completed. Returns an intake ID and estimated provider review time. The intake is reviewed by a licensed US healthcare provider who makes all prescribing decisions. Requires authentication.

destructive

Argument	Type	Description
bearer_token	string	Authentication token for the patient session
patient_name*	string	Patient's full legal name
patient_email*	string	Patient's email address
intake_answers*	object	Completed intake questionnaire answers from intake_questions

Input schema (JSON)

{
  "type": "object",
  "title": "submit_intakeArguments",
  "required": [
    "patient_email",
    "patient_name",
    "intake_answers"
  ],
  "properties": {
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    },
    "patient_name": {
      "type": "string",
      "title": "Patient Name",
      "description": "Patient's full legal name"
    },
    "patient_email": {
      "type": "string",
      "title": "Patient Email",
      "description": "Patient's email address"
    },
    "intake_answers": {
      "type": "object",
      "title": "Intake Answers",
      "description": "Completed intake questionnaire answers from intake_questions",
      "additionalProperties": true
    }
  }
}

medications_availability

Check if a specific medication is available for shipping to the patient's state. Some compounded medications have state-specific restrictions based on pharmacy licensing. Returns availability status and reason if unavailable.

read-only

Argument	Type	Description
state*	string	US state abbreviation (e.g. 'CA', 'NY', 'TX')
client_ip	string	Client IP address for rate limiting
medication*	string	Medication name to check availability for

Input schema (JSON)

{
  "type": "object",
  "title": "check_availabilityArguments",
  "required": [
    "medication",
    "state"
  ],
  "properties": {
    "state": {
      "type": "string",
      "title": "State",
      "description": "US state abbreviation (e.g. 'CA', 'NY', 'TX')"
    },
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    },
    "medication": {
      "type": "string",
      "title": "Medication",
      "description": "Medication name to check availability for"
    }
  }
}

medications_categories

List all medication categories available through the telehealth platform: Weight Loss (GLP-1 medications), Peptide Therapy (sermorelin, growth hormone peptides), Anti-Aging & Longevity (NAD+, glutathione), and other treatment categories. Each category includes a description and count of available medications.

read-only

Argument	Type	Description
client_ip	string	Client IP address for rate limiting

Input schema (JSON)

{
  "type": "object",
  "title": "list_categoriesArguments",
  "properties": {
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    }
  }
}

medications_details

Get detailed information about a specific medication including: all available dosage strengths and titration schedules, available forms (injectable vials, pre-filled syringes, oral dissolving tablets, sublingual drops), all active plan options with pricing for each, what's included (provider consultation, medication, shipping, ongoing support), contraindications, and common side effects. Supports queries by medication name (e.g. 'semaglutide', 'tirzepatide', 'sermorelin', 'NAD+', 'glutathione') or by category (e.g. 'weight loss', 'peptides', 'anti-aging'). Use this to look up exact plan durations and pricing.

read-only

Argument	Type	Description
category	any	Filter by category (e.g. 'weight loss', 'peptides', 'anti-aging')
client_ip	string	Client IP address for rate limiting
medication*	string	Medication name (e.g. 'semaglutide', 'tirzepatide', 'sermorelin', 'NAD+', 'glutathione')

Input schema (JSON)

{
  "type": "object",
  "title": "get_medication_detailsArguments",
  "required": [
    "medication"
  ],
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Category",
      "default": null,
      "description": "Filter by category (e.g. 'weight loss', 'peptides', 'anti-aging')"
    },
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    },
    "medication": {
      "type": "string",
      "title": "Medication",
      "description": "Medication name (e.g. 'semaglutide', 'tirzepatide', 'sermorelin', 'NAD+', 'glutathione')"
    }
  }
}

medications_list

List all available prescription medications including GLP-1 weight loss drugs (compounded semaglutide, compounded tirzepatide), peptide therapies (sermorelin for growth hormone support, NAD+ for cellular energy and anti-aging, glutathione for antioxidant support), and other compounded wellness treatments. Returns medication names, categories, available forms (injectable, oral tablet, sublingual drops, nasal spray), and starting prices. All medications are compounded by US-licensed 503A pharmacies and require evaluation by a licensed US healthcare provider before prescribing.

read-only

Argument	Type	Description
client_ip	string	Client IP address for rate limiting

Input schema (JSON)

{
  "type": "object",
  "title": "list_medicationsArguments",
  "properties": {
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    }
  }
}

medications_pricing

Get detailed pricing for a specific medication, form, and plan duration. Returns price breakdown including medication cost, provider consultation fee, shipping, and any applicable discounts for longer plans. Plan durations vary by medication — use medications_details first to see available plan_months values. Supports semaglutide, tirzepatide, sermorelin, NAD+, glutathione and all other available medications.

read-only

Argument	Type	Description
form*	string	Medication form: 'injectable', 'tablet', or 'drops'
client_ip	string	Client IP address for rate limiting
medication*	string	Medication name
plan_months*	integer	Plan duration in months (1, 4, or 6)

Input schema (JSON)

{
  "type": "object",
  "title": "get_pricingArguments",
  "required": [
    "medication",
    "form",
    "plan_months"
  ],
  "properties": {
    "form": {
      "type": "string",
      "title": "Form",
      "description": "Medication form: 'injectable', 'tablet', or 'drops'"
    },
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    },
    "medication": {
      "type": "string",
      "title": "Medication",
      "description": "Medication name"
    },
    "plan_months": {
      "type": "integer",
      "title": "Plan Months",
      "description": "Plan duration in months (1, 4, or 6)"
    }
  }
}

order_create

Create a new prescription medication order. The patient must have completed intake questionnaire and consent before ordering. Required: medication name, selected form (injectable, tablet, drops), plan duration (1, 4, or 6 months), shipping address. The order is reviewed by a licensed US healthcare provider who makes the final prescribing decision. If approved, medication is compounded at a US-licensed 503A pharmacy and shipped directly to the patient. Returns order ID, estimated provider review time, and expected delivery window. Payment is processed via Stripe Agentic Commerce Protocol (ACP). Requires authentication.

destructive

Argument	Type	Description
form*	string	Medication form: 'injectable', 'tablet', or 'drops'
intake_id*	string	Approved intake ID from intake_submit
medication*	string	Medication name to order
plan_months*	integer	Plan duration in months (1, 4, or 6)
bearer_token	string	Authentication token for the patient session
shipping_address*	object	Shipping address with keys: line1, city, state, zip, and optional line2

order_documents

Get the list of documents a patient needs to upload for their order. Returns required documents (photo ID, selfie for verification) with upload status and accepted file formats. Requires authentication.

read-only

Argument	Type	Description
order_id*	string	Order ID to check required documents for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_required_documentsArguments",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID to check required documents for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

order_status

Get the current status of a medication order. Returns status (pending_review, provider_reviewing, approved, needs_info, denied, compounding, shipped, delivered), tracking information, and delivery estimate. Requires authentication.

read-only

Argument	Type	Description
order_id*	string	Order ID from order_create
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_order_statusArguments",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID from order_create"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

order_upload

Upload a verification document for a medication order. Accepts photo ID and selfie as base64-encoded files. Supported formats: PDF, JPEG, PNG. Maximum size: 10MB. Requires authentication.

destructive

Argument	Type	Description
order_id*	string	Order ID to upload document for
file_name*	string	Original filename with extension (e.g. 'license.jpg')
file_base64*	string	Base64-encoded file content (PDF, JPEG, or PNG, max 10MB)
bearer_token	string	Authentication token for the patient session
document_type*	string	Document type: 'photo_id' or 'selfie'

Input schema (JSON)

{
  "type": "object",
  "title": "upload_documentArguments",
  "required": [
    "order_id",
    "document_type",
    "file_base64",
    "file_name"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID to upload document for"
    },
    "file_name": {
      "type": "string",
      "title": "File Name",
      "description": "Original filename with extension (e.g. 'license.jpg')"
    },
    "file_base64": {
      "type": "string",
      "title": "File Base64",
      "description": "Base64-encoded file content (PDF, JPEG, or PNG, max 10MB)"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    },
    "document_type": {
      "type": "string",
      "title": "Document Type",
      "description": "Document type: 'photo_id' or 'selfie'"
    }
  }
}

portal_care_plan

Get the patient's current care plan including: current medication, current dosage, titration schedule, next dose adjustment date, upcoming refill date, provider notes, and weight progress summary. Requires authentication.

read-only

Argument	Type	Description
patient_id*	string	Patient ID
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_care_planArguments",
  "required": [
    "patient_id"
  ],
  "properties": {
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

portal_log_side_effects

Log side effects a patient is experiencing. If severity is 'severe', the case is auto-flagged for immediate provider review and returns urgent guidance. Requires authentication.

destructive

Argument	Type	Description
effects*	array	List of side effects being experienced (e.g. ['nausea', 'headache'])
severity*	string	Severity level: 'mild', 'moderate', or 'severe'
patient_id*	string	Patient ID
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "log_side_effectsArguments",
  "required": [
    "patient_id",
    "effects",
    "severity"
  ],
  "properties": {
    "effects": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Effects",
      "description": "List of side effects being experienced (e.g. ['nausea', 'headache'])"
    },
    "severity": {
      "type": "string",
      "title": "Severity",
      "description": "Severity level: 'mild', 'moderate', or 'severe'"
    },
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

portal_log_weight

Log a patient's weight for tracking progress on their treatment plan. Requires patient_id, weight in pounds, and date (ISO 8601). Requires authentication.

destructive

Argument	Type	Description
date*	string	Date of weight measurement in ISO 8601 format (YYYY-MM-DD)
patient_id*	string	Patient ID
weight_lbs*	number	Weight in pounds
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "log_weightArguments",
  "required": [
    "patient_id",
    "weight_lbs",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "title": "Date",
      "description": "Date of weight measurement in ISO 8601 format (YYYY-MM-DD)"
    },
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "weight_lbs": {
      "type": "number",
      "title": "Weight Lbs",
      "description": "Weight in pounds"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

portal_message

Send a message to the patient's healthcare provider. Returns sent confirmation and estimated response time. Urgent messages (containing keywords like 'emergency', 'chest pain', 'difficulty breathing') are flagged for priority response. Requires authentication.

destructive

Argument	Type	Description
message*	string	Message text to send to the healthcare provider
patient_id*	string	Patient ID
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "message_providerArguments",
  "required": [
    "patient_id",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "title": "Message",
      "description": "Message text to send to the healthcare provider"
    },
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

portal_refill

Request a medication refill for the patient's current prescription. Creates a refill order that will be reviewed by a provider within 24-48 hours. Requires authentication.

destructive

Argument	Type	Description
patient_id*	string	Patient ID
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "request_refillArguments",
  "required": [
    "patient_id"
  ],
  "properties": {
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

portal_support

Contact customer support with a question or issue. Creates a support ticket and returns the ticket ID and estimated response time. Requires authentication.

destructive

Argument	Type	Description
message*	string	Detailed description of the question or issue
subject*	string	Support ticket subject line
patient_id*	string	Patient ID
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "contact_supportArguments",
  "required": [
    "patient_id",
    "subject",
    "message"
  ],
  "properties": {
    "message": {
      "type": "string",
      "title": "Message",
      "description": "Detailed description of the question or issue"
    },
    "subject": {
      "type": "string",
      "title": "Subject",
      "description": "Support ticket subject line"
    },
    "patient_id": {
      "type": "string",
      "title": "Patient Id",
      "description": "Patient ID"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

provider_questions

Get follow-up questions from the healthcare provider for a specific order. The provider may request additional information before making a prescribing decision. Returns the questions if the order status is 'needs_info', or a message that no questions are pending. Requires authentication.

read-only

Argument	Type	Description
order_id*	string	Order ID to get provider questions for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "get_provider_questionsArguments",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID to get provider questions for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

provider_respond

Submit answers to provider follow-up questions for a specific order. The responses are sent to the provider for review. Returns confirmation and updated order status. Requires authentication.

destructive

Argument	Type	Description
answers*	object	Answers to the provider's follow-up questions keyed by question ID
order_id*	string	Order ID to submit responses for
bearer_token	string	Authentication token for the patient session

Input schema (JSON)

{
  "type": "object",
  "title": "submit_provider_responseArguments",
  "required": [
    "order_id",
    "answers"
  ],
  "properties": {
    "answers": {
      "type": "object",
      "title": "Answers",
      "description": "Answers to the provider's follow-up questions keyed by question ID",
      "additionalProperties": true
    },
    "order_id": {
      "type": "string",
      "title": "Order Id",
      "description": "Order ID to submit responses for"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "title": "check_eligibilityArguments",
  "required": [
    "age",
    "state"
  ],
  "properties": {
    "age": {
      "type": "integer",
      "title": "Age",
      "description": "Patient's age in years (must be 18+). Confirm with the patient before submitting."
    },
    "bmi": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bmi",
      "default": null,
      "description": "Patient's Body Mass Index. Required for GLP-1 / weight-loss eligibility (must be 20+). Omit for longevity products. Compute from confirmed height + weight; don't ask the patient to compute it themselves."
    },
    "sex": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Sex",
      "default": null,
      "description": "Patient's biological sex. Pass 'female' when you'll also pass `pregnancy_status` (so the server knows pregnancy screening was considered). Pass 'male' to make it explicit that pregnancy screening doesn't apply. Omit if the patient hasn't been asked yet and the product doesn't require sex for eligibility."
    },
    "state": {
      "type": "string",
      "title": "State",
      "description": "US state abbreviation (e.g. 'CA', 'NY') where the patient resides. Confirm before submitting."
    },
    "client_ip": {
      "type": "string",
      "title": "Client Ip",
      "default": "",
      "description": "Client IP address for rate limiting"
    },
    "conditions": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Conditions",
      "default": null,
      "description": "List of diagnosed medical conditions the patient confirms they have. Disqualifiers include medullary thyroid carcinoma (MTC) and MEN2 syndrome. Omit if the patient has no diagnosed conditions or hasn't been asked yet."
    },
    "pregnancy_status": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Pregnancy Status",
      "default": null,
      "description": "Pregnancy status. Use one of these exact values: 'not pregnant', 'currently pregnant', 'planning pregnancy', 'breastfeeding'. ONLY applies when sex == 'female'. OMIT this parameter entirely for biological males — do NOT ask males about pregnancy."
    }
  }
}

{
  "type": "object",
  "title": "create_orderArguments",
  "required": [
    "intake_id",
    "medication",
    "form",
    "plan_months",
    "shipping_address"
  ],
  "properties": {
    "form": {
      "type": "string",
      "title": "Form",
      "description": "Medication form: 'injectable', 'tablet', or 'drops'"
    },
    "intake_id": {
      "type": "string",
      "title": "Intake Id",
      "description": "Approved intake ID from intake_submit"
    },
    "medication": {
      "type": "string",
      "title": "Medication",
      "description": "Medication name to order"
    },
    "plan_months": {
      "type": "integer",
      "title": "Plan Months",
      "description": "Plan duration in months (1, 4, or 6)"
    },
    "bearer_token": {
      "type": "string",
      "title": "Bearer Token",
      "default": "",
      "description": "Authentication token for the patient session"
    },
    "shipping_address": {
      "type": "object",
      "title": "Shipping Address",
      "description": "Shipping address with keys: line1, city, state, zip, and optional line2",
      "additionalProperties": true
    }
  }
}