Use the Hi Doctor MCP connector in an AI agent

An AI agent or consumer app uses Hi Doctor through the MCP connector at https://mcp.hi-doctor.ai/mcp, acting for one patient who signs in on hi-doctor.ai with OAuth. Consequential actions wait for the patient’s approval on Hi Doctor, and the agent never gives medical advice. This page explains what the tools can and cannot do and gives a copy-paste prompt for the agent. Last reviewed: 2026-11-05 Building a server-to-server integration for a partner platform instead? See Integrate the Partner API with an AI coding agent.

​

How do I connect the agent?

Add https://mcp.hi-doctor.ai/mcp as a remote MCP server in the agent’s client, following its guide: Claude, ChatGPT, Cursor or VS Code. For your own client, see Connect and Streamable HTTP.

​

How do OAuth and approvals work?

• OAuth. The patient signs in on hi-doctor.ai, or creates an account in the same flow, and approves the permissions. The agent never sees the password and acts with that patient’s permissions only.
• Approvals. Actions with consequences, such as sending a message, submitting a questionnaire or cancelling a plan, return an approval link. The patient approves on Hi Doctor, then the agent commits the action. See Approval links.

​

What can the tools do, and what can they not do?

Read-only tools carry a read-only hint, so a client can run them without asking. The full list is the patient tools reference.

​

What prompt should the agent follow?

Add this to the agent’s system prompt and keep every rule. The longer version, with the questionnaire protocol and error handling, is on Build on Hi Doctor with AI.

​

Where can the agent read more?

• /llms.txt: an index of the docs written for agents.
• /skill.md: reviewed rules an agent can load; installing it grants no permissions.

​

Frequently asked questions

​

Does the agent need an API key?

No. The patient signs in on hi-doctor.ai with OAuth and approves the connection. The agent then acts with the permissions of that patient only.

​

Can the agent approve an action itself?

No. Consequential actions return an approval link, and only the patient approves it on Hi Doctor. The agent commits the action after approval.

​

Can the agent give medical advice?

No. The agent must never suggest a medicine or a dose. Every consultation is reviewed in full by an EU-licensed doctor, who decides on medical grounds only.

​

Can the agent answer the questionnaire for the patient?

No. It asks each question as written and records only what the patient said. A guessed answer becomes part of the record a doctor reviews.

​

Which clients can connect?

Any client that supports remote MCP servers with OAuth, including Claude, ChatGPT, Cursor and VS Code. Each has its own setup guide.

​

Is the Partner API the same as the MCP connector?

No. The MCP connector acts for one signed-in patient. The Partner API is a server-to-server API for partner platforms. See Integrate the Partner API with an AI coding agent.

​

Next steps