Hi Doctor MCP patient tools: full reference

This is the full reference for the tools a patient account sees after connecting the Hi Doctor MCP connector. Each tool acts as the signed-in patient and can only read or change that patient’s own records, under the same rules as the website. Tools with consequences use an approval link, so nothing happens until the patient approves the exact action on Hi Doctor. Last reviewed: 2026-11-04 As of 2026-11-04 the catalog lists 70 tools. The tool list your client shows is the source of truth for your connection, and changes are recorded in the changelog. Tools whose permission the patient did not approve are left out of the client’s tool list. For step-by-step tasks, see Workflows.

Two older names stay callable but are hidden from the tool list. Update saved prompts and scripts to the new names:

hidoctor_progress_injections_log now runs hidoctor_progress_injection_log
hidoctor_progress_notes_add now runs hidoctor_progress_note_log

Which permission does each tool area need?

Each tool needs one or more permissions (OAuth scopes). A few actions need two or three, and the tables below say so next to the tool. See Permissions for what each permission grants.

Scope	Used by
`hidoctor:profile`	Profile, operation status, account export and deletion, guides and prescription verification
`hidoctor:consultations`	Consultations, billing, prescriptions, documents, photos, renewals, referrals and safety reports
`hidoctor:messages`	Conversations with the medical team and attachments
`hidoctor:questionnaires`	Questionnaires, renewals and early orders
`hidoctor:checkout`	Checkout, plan changes, renewals and early orders
`hidoctor:progress`	Progress journal
`hidoctor:records:write`	Document and photo changes, account deletion

What do the hints mean?

Each tool carries hints that MCP clients use to decide when to ask you for confirmation. Hints describe behaviour; they never replace Hi Doctor’s own permission checks. They come from the server and lean towards caution: a tool that can overwrite something already saved, such as a questionnaire answer, is marked Destructive even when the patient can change it again later.

Hint	Meaning
Read-only	Does not change anything.
Changes data	Creates or updates something in the account.
Destructive	Deletes, replaces or commits to something that cannot simply be undone.
Repeat-safe	Calling it again with the same arguments has no further effect.
Open world	Its effect reaches beyond the account’s own records, for example Stripe or the medical team.
Approval link	The tool prepares the action and returns an `approval_url`. Nothing happens until a person approves it on Hi Doctor. See Approval links.
Available on the website	The action can be prepared and shown for approval, but it is completed on hi-doctor.ai, not through the connector. See Approval links.

Approval-link tools also accept mode, confirmation_id and idempotency_key. They are left out of the parameter lists below.

What do results and errors look like?

Results include structuredContent that matches each tool’s output schema, plus the same data as JSON text. List tools page with limit, offset and detail (concise or full); see Lists and pagination. Documents, PDFs and exports come back as links with metadata, never as bytes in the result. Errors come back as tool results with isError: true and an error object with code, message, retryable, field_errors, state, next_action and correlation_id. Follow next_action rather than retrying blindly; the codes are explained on Build on Hi Doctor with AI.

Profile

Permission: hidoctor:profile

Tool	What it does	Parameters	Hints
`hidoctor_profile_get` Profile get	Reads the signed-in account’s profile.	None	Read-only
`hidoctor_profile_update` Profile update	Prepares changes to the patient’s own profile. Identity changes are reviewed by Hi Doctor.	`first_name`, `last_name`, `date_of_birth`, `gender`, `country_of_residence`, `timezone`, `locale`, `city`, `postal_code`, `document_number`, `document_type`, `issuing_state`, `address_line1`, `patch`	Changes data, Destructive, Approval link, Available on the website

Approvals

Permission: hidoctor:profile

Tool	What it does	Parameters	Hints
`hidoctor_operation_get` Operation get	Reads the state of an operation prepared by this connection: awaiting approval, approved, declined, expired, executing, uncertain, succeeded or failed. Returns the next step. Never approves anything.	`operation_id` (required)	Read-only

Account and data

Permission: hidoctor:profile

Tool	What it does	Parameters	Hints
`hidoctor_account_export` Account export	Returns the patient’s profile and consultation data as a confidential JSON download, with completeness information. Needs `hidoctor:profile` and `hidoctor:consultations`.	`format`, `locale`	Read-only
`hidoctor_account_preferences_link` Account preferences link	Explains how to open the signed email preference link that Hi Doctor sends by email. It does not create a link.	`locale`	Read-only
`hidoctor_account_delete` Account delete	Prepares deletion and anonymisation of the patient’s own account. Hi Doctor’s retention and subscription rules still apply. Needs `hidoctor:profile` and `hidoctor:records:write`.	None	Changes data, Destructive, Open world, Approval link, Available on the website

Consultations

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_consultations_list` Consultations list	Lists the patient’s own consultations.	`search`, `origin`, `status`, `ordering`, `limit`, `offset`, `detail`. Filters not listed here are rejected from the next MCP server release.	Read-only
`hidoctor_consultation_get` Consultation get	Reads one of the patient’s consultations.	`consultation_id` (required), `detail`, `field`, `offset`, `limit`	Read-only
`hidoctor_consultation_images_get` Consultation images get	Lists the photos of one of the patient’s consultations (`action: "list"`), or returns one as a link (`action: "content"`).	`action` (required), `consultation_id` (required), `image_id`, `limit`, `offset`	Read-only
`hidoctor_consultation_images_change` Consultation images change	Uploads a consultation photo the patient supplied (`action: "upload"`), or prepares deletion of one (`action: "delete"`). Deletion uses an approval link; upload does not. Needs `hidoctor:consultations` and `hidoctor:records:write`.	`action` (required), `consultation_id` (required), `file_ref`, `image_id`	Changes data, Destructive, Approval link

Questionnaires

Permission: hidoctor:questionnaires

Tool	What it does	Parameters	Hints
`hidoctor_questionnaire_categories` Questionnaire categories	Lists the questionnaire categories and their slugs.	None	Read-only
`hidoctor_questionnaire_start` Questionnaire start	Starts or resumes a questionnaire and returns the first unanswered question with progress counts. Answers reused from an earlier questionnaire need the patient’s confirmation. Does not submit anything.	`category_slug` (required), `locale`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`	Read-only
`hidoctor_questionnaire_current` Questionnaire current	Returns the current unanswered question, with its progress and any grid or follow-up item keys. Keeps existing answers.	`category_slug` (required), `locale`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`	Read-only
`hidoctor_questionnaire_answer` Questionnaire answer	Saves one answer, or a batch in `answers`, and returns the next question. `skip: true` is accepted only for optional questions. Copy `values_key` or `option_input_key` from the question to answer one grid item or follow-up. A batch is saved whole or not at all.	`category_slug` (required), `locale`, `question_key`, `values_key`, `option_input_key`, `value`, `values`, `option_inputs`, `additional_info`, `skip`, `answers`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`, `expected_revision`	Changes data, Destructive, Repeat-safe
`hidoctor_questionnaire_back` Questionnaire back	Returns to an earlier question, grid item or follow-up by key, or one step back. Does not change any answer.	`category_slug` (required), `values_key`, `option_input_key`, `question_key`, `locale`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`	Read-only
`hidoctor_questionnaire_review` Questionnaire review	Returns the saved answers as readable labels, plus any required item still missing, so they can be read back to the patient.	`category_slug` (required), `locale`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`	Read-only
`hidoctor_questionnaire_submit` Questionnaire submit	Prepares the reviewed questionnaire for a doctor’s clinical review. Uses the saved answers when none are passed. The patient approves the submission through the approval link.	`category_slug` (required), `answers`, `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `schema_version`, `locale`	Changes data, Destructive, Open world, Approval link
`hidoctor_questionnaire_schema` Questionnaire schema	Reads the full questionnaire schema with saved progress and reusable prefill. Mostly for clients that render their own form.	`category_slug` (required), `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `locale`, `schema_version`	Read-only
`hidoctor_questionnaire_save_progress` Questionnaire save progress	Replaces the saved draft answers without sending them for review.	`category_slug` (required), `answers` (required), `renewal_origin`, `renewal_changed`, `treatment_id`, `consultation_id`, `dosage`, `locale`, `schema_version`	Changes data, Destructive, Repeat-safe
`hidoctor_questionnaire_legacy_submit` Questionnaire legacy submit	Prepares submission of an older form for a category that has no guided questionnaire.	`type` (required), `data` (required), `renewal_origin`	Changes data, Destructive, Approval link, Available on the website

Checkout and billing

Permission: hidoctor:checkout, hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_checkout_create` Checkout create	Prepares checkout for the treatment the patient chose: a Stripe payment link, or an existing consultation already covered by the plan. Payment happens on Stripe’s page.	`treatment_id` (required), `dosage` (required), `plan`, `return_path`, `locale`, `form`, `promo_code`, `intake_meta`	Changes data, Destructive, Open world, Approval link, Available on the website
`hidoctor_checkout_status` Checkout status	Checks a checkout session. A paid session can be finalised by this call, which creates its consultation.	`session_id`, `provider`, `consultation_id`	Changes data, Destructive
`hidoctor_subscription_get` Subscription get	Reads the patient’s plans, billing intervals, entitlements and cancellation state. Does not change renewal or billing.	None	Read-only
`hidoctor_subscription_cancel` Subscription cancel	Prepares cancellation of one plan at the end of the paid period, never immediately. Access continues until that date. Needs `hidoctor:consultations` and `hidoctor:checkout`.	`subscription_id`	Changes data, Destructive, Open world, Approval link
`hidoctor_subscription_reactivate` Subscription reactivate	Prepares undoing a scheduled period-end cancellation, so the plan keeps renewing. Needs `hidoctor:consultations` and `hidoctor:checkout`.	`subscription_id`	Changes data, Destructive, Open world, Approval link
`hidoctor_subscription_early_order` Subscription early order	Prepares bringing the next renewal forward and creating its consultation now. Allowed once per paid period and cannot be undone. Needs `hidoctor:checkout`, `hidoctor:consultations` and `hidoctor:questionnaires`.	`category` (required), `reason`, `treatment_id`, `dosage`, `changed`, `answers`, `change_note`	Changes data, Destructive, Open world, Approval link
`hidoctor_subscription_billing_portal` Subscription billing portal	Creates a confidential link to the Stripe billing portal for card, plan and billing details.	`return_path`	Changes data, Open world
`hidoctor_payments_list` Payments list	Lists the patient’s payments.	`limit`, `offset`, `detail`	Read-only
`hidoctor_payment_invoice` Payment invoice	Returns the invoice as a link with metadata, not as bytes. Treat it as confidential.	`payment_id` (required), `locale`	Read-only
`hidoctor_payment_credit_note` Payment credit note	Returns the credit note for a refund on one of the patient’s payments, as a link with metadata.	`payment_id` (required), `refund_id` (required), `locale`	Read-only

Renewals

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_renewal_get` Renewal get	Reads current renewal choices, the questions they need, prices and any block (`action: "options"`), or a renewal consultation waiting for the patient’s choice (`action: "pending"`).	`action` (required), `category`	Read-only
`hidoctor_renewal_confirm` Renewal confirm	Prepares the patient’s treatment, dose and answers for a renewal consultation that is waiting for them. Needs `hidoctor:consultations`, `hidoctor:checkout` and `hidoctor:questionnaires`.	`consultation_id` (required), `changed` (required), `treatment_id`, `dosage`, `answers`, `change_note`	Changes data, Destructive, Open world, Approval link

Prescriptions

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_prescriptions_list` Prescriptions list	Lists the patient’s prescriptions.	`limit`, `offset`, `detail`	Read-only
`hidoctor_prescription_pdf` Prescription PDF	Returns the selected prescription PDF as a link with metadata, not as bytes. Treat it as a confidential medical document.	`prescription_id` (required), `kind`	Read-only
`hidoctor_prescription_request_reissue` Prescription request reissue	Prepares a request to the medical team to reissue a prescription that expired or was lost.	`prescription_id` (required), `reason` (required)	Changes data, Destructive, Open world, Approval link, Available on the website

Messages

Permission: hidoctor:messages

Tool	What it does	Parameters	Hints
`hidoctor_messages_unread_summary` Messages unread summary	Reads unread message counts.	None	Read-only
`hidoctor_messages_get_thread` Messages get thread	Reads the patient’s medical-team conversation and its messages without creating it or marking it read.	`limit`, `offset`, `ordering`, `detail`	Read-only
`hidoctor_conversation_open` Conversation open	Opens the patient’s medical-team conversation, reusing it if it already exists.	None	Changes data, Destructive
`hidoctor_conversation_get` Conversation get	Reads the patient’s own conversation details.	`conversation_id` (required)	Read-only
`hidoctor_message_send` Message send	Prepares the exact text of a message to the patient’s medical team. The message is sent only after the patient approves it.	`content` (required), `client_request_id`	Changes data, Destructive, Open world, Approval link
`hidoctor_message_attachment_send` Message attachment send	Prepares a file, uploaded first through the connector’s file upload (`file_ref`), with an optional caption for the medical team.	`file_ref` (required), `conversation_id`, `caption`, `client_request_id`	Changes data, Destructive, Open world, Approval link
`hidoctor_message_attachment_get` Message attachment get	Returns a message attachment as a link with metadata.	`conversation_id` (required), `message_id` (required)	Read-only
`hidoctor_messages_mark_read` Messages mark read	Marks the patient’s conversation as read.	`conversation_id` (required)	Changes data, Destructive, Repeat-safe

Health documents

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_documents_get` Documents get	Lists the patient’s health documents (`action: "list"`), or returns one as a link (`action: "content"`).	`action` (required), `document_id`, `limit`, `offset`	Read-only
`hidoctor_documents_change` Documents change	Uploads a health document the patient supplied (`action: "upload"`), or prepares deletion of one (`action: "delete"`). `kind` is `prescription`, `lab_result`, `photo` or `other`. Deletion uses an approval link; upload does not. Needs `hidoctor:consultations` and `hidoctor:records:write`.	`action` (required), `file_ref`, `document_id`, `kind`, `note`, `consultation_id`	Changes data, Destructive, Approval link

Records

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_orders_list` Orders list	Lists the patient’s own orders. An order is a paid consultation, listed with its prescriptions.	`limit`, `offset`, `detail`, `field`	Read-only

Safety reports

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_adverse_event_report` Adverse event report	Reports a suspected medication side effect to the clinical team for review. Not an emergency channel.	`treatment_id` (required), `medication_name` (required), `description` (required), `severity` (required), `onset_date` (required), `consultation_id`	Changes data, Destructive, Open world
`hidoctor_adverse_events_list` Adverse events list	Lists side effects the patient has reported.	`limit`, `offset`	Read-only

Progress journal

Permission: hidoctor:progress

Tool	What it does	Parameters	Hints
`hidoctor_progress_status` Progress status	Says whether the progress journal is enabled, needs an active subscription, or is unavailable.	None	Read-only
`hidoctor_progress_day_get` Progress day get	Reads one calendar day of weight, injections and notes, with each entry’s ID.	`date` (required)	Read-only
`hidoctor_progress_weight_list` Progress weight list	Lists weight entries.	`limit`, `offset`, `detail`	Read-only
`hidoctor_progress_weight_log` Progress weight log	Logs the weight for a day. There is one weight per day, so this replaces an existing entry for that date. The date defaults to today in the profile’s time zone.	`weight_kg` (required), `logged_on`, `note`	Changes data, Destructive
`hidoctor_progress_weight_update` Progress weight update	Changes fields of a weight entry; omitted fields are kept.	`entry_id` (required), `weight_kg`, `logged_on`, `note`	Changes data, Destructive
`hidoctor_progress_weight_delete` Progress weight delete	Prepares deletion of a weight entry.	`entry_id` (required)	Changes data, Destructive, Approval link, Available on the website
`hidoctor_progress_injections_list` Progress injections list	Lists injection entries.	`limit`, `offset`, `detail`	Read-only
`hidoctor_progress_injection_log` Progress injection log	Adds a new injection entry. Every call creates a separate entry. The time must include its time-zone offset.	`medication` (required), `dose` (required), `injected_at` (required), `injection_site`, `note`	Changes data, Destructive
`hidoctor_progress_injection_update` Progress injection update	Changes fields of an injection entry; omitted fields are kept.	`entry_id` (required), `medication`, `dose`, `injected_at`, `injection_site`, `note`	Changes data, Destructive
`hidoctor_progress_injection_delete` Progress injection delete	Prepares deletion of an injection entry.	`entry_id` (required)	Changes data, Destructive, Approval link, Available on the website
`hidoctor_progress_notes_list` Progress notes list	Lists progress notes.	`limit`, `offset`, `detail`	Read-only
`hidoctor_progress_note_log` Progress note log	Adds a new note. Every call creates a separate entry, even on the same day.	`content` (required), `mood`, `entry_date`	Changes data, Destructive
`hidoctor_progress_note_update` Progress note update	Changes fields of a note; omitted fields are kept.	`entry_id` (required), `content`, `mood`, `entry_date`	Changes data, Destructive
`hidoctor_progress_note_delete` Progress note delete	Prepares deletion of a note.	`entry_id` (required)	Changes data, Destructive, Approval link, Available on the website
`hidoctor_progress_goal_get` Progress goal get	Reads the weight goal.	None	Read-only
`hidoctor_progress_goal_set` Progress goal set	Sets the weight goal.	`target_weight_kg`, `starting_weight_kg`, `target_date`	Changes data, Destructive
`hidoctor_progress_plan_get` Progress plan get	Reads the injection plan.	None	Read-only
`hidoctor_progress_plan_set` Progress plan set	Creates or updates the injection plan; omitted fields are kept. Preferred times use HH:MM; the older morning, afternoon and evening values are read as 09:00, 14:00 and 19:00.	`medication`, `preferred_time`, `starts_on`, `anchor_weekday`	Changes data, Destructive

Referrals

Permission: hidoctor:consultations

Tool	What it does	Parameters	Hints
`hidoctor_referrals_get` Referrals get	Reads the patient’s referral profile, referred people, transactions or monthly commission (`section`: `profile`, `referred`, `transactions` or `monthly`).	`section` (required), `limit`, `offset`, `referred_user_id`	Read-only
`hidoctor_referrals_activate` Referrals activate	Prepares activation of the patient’s referral programme and promotion code.	None	Changes data, Destructive, Open world, Approval link, Available on the website

Guides and verification

Permission: hidoctor:profile

Tool	What it does	Parameters	Hints
`hidoctor_navigation_get` Navigation get	Returns a link to an allowed public page, such as a treatment guide, pharmacy search or contact form. Public forms with a challenge need a person.	`destination` (required), `locale`	Read-only
`hidoctor_prescription_verify` Prescription verify	Checks a prescription verification code against Hi Doctor’s public verification service. Returns masked details only.	`verification_token` (required)	Read-only

What can no tool do?

No tool approves an action for the patient: approval happens only on Hi Doctor, after the patient signs in. Approving a consultation, issuing or changing a prescription and changing a dose are decisions for the patient’s doctor, and no tool available to a patient performs them. Clinical eligibility is decided by Hi Doctor’s servers when a questionnaire is submitted. See Safety.

Next steps

Workflows

Common tasks, step by step.

Build on Hi Doctor with AI

The questionnaire loop and the rules an assistant follows.

Approval links

How the patient approves an action on Hi Doctor.

Permissions

What each permission grants and how to add one.

Ready to try it? Connect Hi Doctor in your client.

Start

Use

Reference

Trust

Updates

Hi Doctor MCP patient tools: full reference

Which permission does each tool area need?

What do the hints mean?

What do results and errors look like?

Profile

Approvals

Account and data

Consultations

Questionnaires

Checkout and billing

Renewals

Prescriptions

Messages

Health documents

Records

Safety reports

Progress journal

Referrals

Guides and verification

What can no tool do?

Next steps

Workflows

Build on Hi Doctor with AI

Approval links

Permissions

​Which permission does each tool area need?

​What do the hints mean?

​What do results and errors look like?

​Profile

​Approvals

​Account and data

​Consultations

​Questionnaires

​Checkout and billing

​Renewals

​Prescriptions

​Messages

​Health documents

​Records

​Safety reports

​Progress journal

​Referrals

​Guides and verification

​What can no tool do?

​Next steps

Workflows

Build on Hi Doctor with AI

Approval links

Permissions

Which permission does each tool area need?

What do the hints mean?

What do results and errors look like?

Profile

Approvals

Account and data

Consultations

Questionnaires

Checkout and billing

Renewals

Prescriptions

Messages

Health documents

Records

Safety reports

Progress journal

Referrals

Guides and verification

What can no tool do?

Next steps