Start Session
auth_startStart 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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"email": "<email>",
"phone": "<phone>",
"first_name": "<first_name>"
},
"name": "auth_start"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Yes | Patient's email address | ||
| phone | Yes | Patient's phone number (US format) | |
| last_name | No | Patient's last name | |
| first_name | Yes | Patient's first name |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |