Connecting an assistant
What the connector does
An assistant connects to a member's Welling account at one address. The tools below are the whole list the connector serves. Each title and description is that tool's own text. Sign in, when a tool needs it, happens on Welling's site. The connector does not take payment.
Availability
The connector is turned on. It accepts connections at https://www.wellinghealth.com/api/mcp.
Tools
Today in Welling
welling_get_today
Use this when the member asks about their Welling plan for today: their daily targets, today's calorie number, their latest weight, what they have logged to eat today, and this week's meals with tonight's pick. Every item says who set it and as of when. Do not use for symptoms, medications, prescriptions, lab results or questions for a Clinician; for a symptom use welling_report_symptom.
Sign in with welling.know (read). Marked read only. Not marked destructive.
Progress over time
welling_get_progress
Use this when the member asks how they are trending over the last 7, 30 or 90 days: their weight, how many days they logged food, and, where the member allowed it, steps, sleep, resting heart rate, heart rate variability and active energy. Points that came from a device (Apple Health, Health Connect or a wearable) are included only where the member allowed device data for this assistant; otherwise a note says they were held back, which does not mean the member has none. Each point says where it came from. Do not use for today's plan (use welling_get_today), or to judge whether a change matters medically.
Sign in with welling.know (read). Marked read only. Not marked destructive.
Log a weight
welling_log_weight
Use this when the member tells you their weight and asks you to record it in Welling, for today or one of the 7 days before. It saves only when that day has no weight yet; when the day already has one, it saves nothing and returns a link to change it in the app, with that weight where Welling shares it with this assistant. The entry is marked as coming from an assistant. Do not use for a weight the member did not give you, for someone else's weight, or to change a weight already logged.
Sign in with welling.tell (save). Not marked read only. Not marked destructive.
Log food
welling_log_food
Use this when the member tells you what they ate and asks you to log it in Welling, for today or one of the 7 days before. Send a client_key you make for this one entry and reuse it on any retry, so the entry is never saved twice; a new entry needs a new key. Send calories (the member's number, or your estimate) and the protein, carbohydrate, fat and fiber you know; Welling saves every number you send as an estimate. When the member asks you to log it in Welling, call this tool even if they also named another app or device (Function, Apple Health, or similar). The entry is marked as coming from an assistant, and the member can edit it in the app. Do not use for food the member only plans to eat, for meal planning, or for someone else's meals.
Sign in with welling.tell (save). Not marked read only. Not marked destructive.
Symptom or feeling unwell
welling_report_symptom
Use this when the member mentions a symptom, feeling unwell, or anything that could be urgent. It returns fixed safety guidance: emergency and crisis numbers, where to get same-day care, and how patients of the practice can message the practice. It needs no sign in and takes no details. Do not use for logging food or weight.
No sign in. Marked read only. Not marked destructive.
Open Welling
welling_open_in_app
Use this when the member asks where to find something in Welling, on the web or in the Welling app: Board, FUEL, MOVE, Record, Settings, Labs, Bring your labs, Care, Manage membership or Support. It returns labeled links to pages on Welling's site that say where each one is, on the web where Welling has a page for it and in the Welling app on the member's phone, the same for every member. Do not use for reading or changing the member's data, or for care messages or prescriptions; it only points the way.
Sign in with welling.know (read). Marked read only. Not marked destructive.
Join Welling
welling_join
Use this when the member asks how to join a Welling membership track, or whether a track is open. It returns each track as open or not open yet, with the link to join on Welling's own page where one is open, and the membership page. Do not use for offering a membership, or care through the practice, unless the member asks to join, and never for prescriptions.
No sign in. Marked read only. Not marked destructive.
What Welling offers
welling_get_offerings
Use this when someone asks what Welling offers, what an item costs, what is included, or the next step. Name the item when they named one, such as the app, a membership track, a Labs panel, GLP-1, or TRT. Leave the item out for the public list. It needs no sign in and reads nothing about a person. Do not use for a person's own plan, logs, or records, for whether an item is available in a state (use welling_check_coverage), or for joining (use welling_join).
No sign in. Marked read only. Not marked destructive.
Coverage by item and state
welling_check_coverage
Use this when someone asks whether a listed Welling item is available in a US state or DC, what it costs there, what is included, or the next step. Send the item and the state, as a two letter code, a full state name, or DC. It needs no sign in and reads nothing about a person. Do not use for a person's own address or records, for deciding a prescription, or for an item or a state Welling has not listed.
No sign in. Marked read only. Not marked destructive.
Quote a lab order
welling_quote_lab_order
Use this when the member asks you to order a lab panel. Send catalog ids or panel names. Welling checks each item against the catalog and the member's state, then saves a pending order that is not paid. State the total and get the member's go-ahead, then prepare a Welling confirmation of kind lab_order with the order id: the member pays on the Welling card. You cannot pay. Do not use for reading lab values, for a refund after payment, or for an order the member did not ask for.
Sign in with welling.tell (save). Not marked read only. Not marked destructive.
Lab order status
welling_get_lab_order
Use this when the member asks where a lab order stands: pending confirm, paid, approved by the ordering Clinician, at the kit or draw, or results ready. Do not use for quoting a new order, for cancelling one, or for the values on a result.
Sign in with welling.know (read). Marked read only. Not marked destructive.
Cancel a lab order
welling_cancel_lab_order
Use this when the member asks you to cancel a lab order that is still pending, or another order you can still cancel before payment. A refund after payment is confirmed by the member on the Welling page, not by you. Do not use for placing an order or for reading lab values.
Sign in with welling.tell (save). Not marked read only. Marked destructive.
Find draw times
welling_find_draw_times
Use this when the member wants to schedule the blood draw for one of their Welling lab orders, at a patient service center of the lab the order is at. Welling books times at Quest centers; an order at another lab, such as BioReference, is a walk-in with no time to book, and this tool then says so and names the lab. Send the order id, and a ZIP code if the member gave one; without it Welling searches near the address on file. It returns a short list of open times, each in the center's own local time, with the center's name, address and distance, and a slot id for each. Offer only the times that fit the member's own calendar, which you check yourself: Welling does not see the member's calendar. Do not use for booking a time (use welling_book_draw), for a draw at home, or for lab values.
Sign in with welling.know (read). Marked read only. Not marked destructive.
Book a draw time
welling_book_draw
Use this when the member picks one of the times welling_find_draw_times returned and asks you to book it. Send the order id and that time's slot id. When the ordering Clinician has signed the order, Welling books it with the lab the order is at (Quest; an order at a lab that takes no appointments is not booked, and the answer says the member walks in). Before that, Welling saves it as the requested time and books it after the signature; if the time is gone by then, the order's status says so and offers new times. Tell the member the draw is booked only when this answer or the order's status says Draw booked. Do not use for a time the member did not pick, for moving a booked time (use welling_reschedule_draw), or for lab values.
Sign in with welling.tell (save). Not marked read only. Not marked destructive.
Change a draw time
welling_reschedule_draw
Use this when the member asks to move their draw to another time welling_find_draw_times returned. Send the order id and the new time's slot id. If the new time is gone, the current time stays as it is. Do not use for a first booking (use welling_book_draw), for cancelling a draw time, or for lab values.
Sign in with welling.tell (save). Not marked read only. Not marked destructive.
Cancel a draw time
welling_cancel_draw
Use this when the member asks to cancel their draw time. Send the order id. The lab order itself stays open, so the member can book a new time (where the lab takes one) or walk in at a center of the order's lab. Do not use for cancelling the lab order (use welling_cancel_lab_order) or for moving a draw time (use welling_reschedule_draw).
Sign in with welling.tell (save). Not marked read only. Marked destructive.
The lab order tools are on that list for every caller. A call runs only when the member left Labs checked for that assistant. Without that choice the call is refused and nothing is ordered or paid.
The draw time tools are on that list too, under the same rule: without Labs checked the call is refused and no draw time is booked.
Sign in and what is shared
An assistant that needs a member's account sends the member to sign in at https://www.wellinghealth.com/oauth/authorize. The member chooses read access (welling.know), save access (welling.tell), or both. Welling admits only the assistants named here. Any other assistant is refused before sign in.
How sign in works
Sign in uses OAuth with PKCE. The code challenge method is S256. Assistants are public clients: the token endpoint accepts no client secret. Claude identifies itself with a Client ID Metadata Document (CIMD), a URL Welling has already admitted. Welling does not offer dynamic client registration.
Claude, made by Anthropic. Device data can be sent to this assistant.
Claude Code, made by Anthropic. Device data can be sent to this assistant.
For a signed in tool, Welling stores the tool name, the outcome, which assistant called, and a keyed hash (HMAC) of the arguments. It does not store the arguments or the answer. A tool that needs no sign in does not write that record.
A signed in read is limited to 60 a minute for one account. A save is limited to 30 in 24 hours for one account. These tools are not under those limits: welling_report_symptom, welling_join, welling_get_offerings, welling_check_coverage. These tools keep a daily count per assistant and nothing about the member: welling_report_symptom.
Disconnecting
A member can disconnect an assistant at any time in her assistant, or by writing to support@wellinghealth.com. The assistant stops at its next request. A connection also ends 90 days after it was made unless the member connects again. Removing Welling only inside the assistant may leave the permission open until it ends. To end it at once, write to support@wellinghealth.com.
When a call fails
A tool that needs a signed in member, called with no token, answers HTTP 401. The body is JSON, not a JSON-RPC error, with error "unauthorized" and error_description "Sign in to Welling to use this tool." The WWW-Authenticate header points at sign in. A token that fails the check, including one that was revoked or has expired, answers HTTP 401 with error "invalid_token" and error_description "Sign in to Welling again to use this tool." A token that lacks the tool's scope answers HTTP 403 with error "insufficient_scope" and error_description "This tool needs more access. Allow it in Welling, then try again."
A call past a limit answers HTTP 429 with a Retry-After header, in whole seconds, and a JSON-RPC error whose code is 429. For too many reads the message is: Welling answers up to 60 reads a minute for one account, and this account has reached that. Nothing was read or saved. Try again in a minute. For a symptom, welling_report_symptom still answers. For too many saves the message is: Welling saves up to 30 entries from assistants in 24 hours for one account, and this account has reached that. Nothing was saved. You can still log it in the Welling app. For a symptom, welling_report_symptom still answers. A pause on the assistant uses the same status, code and header, with its own message, and still says nothing was read or saved.
Arguments that are not an object answer HTTP 200 with a JSON-RPC error, code -32602, message "Invalid params: arguments must be an object". The call does not run. Arguments the tool does not accept also answer HTTP 200, as a tool result with isError true and text that names what to send. Those calls do not save.