What an assistant can read
The server provides eight tools. Each tool reads records that OpenHealth publishes on its site.
list_procedures: This tool lists the procedures OpenHealth covers, shows which procedures have doctor scores and links to each procedure page.find_doctors_for_procedure: This tool lists up to five doctors for a procedure near a city or ZIP code. It uses the same order as the site and returns each grade, distance and ordering rule.search_providers: This tool finds doctors or hospitals by name and returns the NPI or CMS certification number used by the other tools. A hospital search requires a state.get_doctor: This tool returns a doctor's public record by NPI. The record includes offices, specialties, procedure scores with grades, affiliated hospitals, exclusion checks and published outcomes.check_doctor_insurance: This tool shows whether the insurer directories OpenHealth reads list a doctor. It also returns the date of each listing check.get_hospital: This tool returns a hospital's public record. The record includes the address, CMS star rating, owners, ownership changes, published outcomes and whether OpenHealth holds its price file.get_hospital_prices: This tool returns the prices that a hospital publishes in its price file for a service or billing code. It also returns the file link and the date OpenHealth read it.get_data_sources: This tool lists the public sources behind the current release. It returns each source's link and release date.
Connect OpenHealth
Add this server address to an assistant that supports remote MCP servers. MCP means Model Context Protocol. Assistants use MCP to connect to outside tools. The server needs no sign-in.
https://getopenhealth.org/mcpClaude on the web, desktop and mobile
Open the prefilled form while signed in to Claude. Check the name and address. Choose No sign-in for authentication, then select Add.
To add OpenHealth by hand, go to Customize > Connectors, select Add, then Add custom connector. Enter OpenHealth as the name and enter the server address. Choose No sign-in, then select Add.
Add OpenHealth once on claude.ai or in the desktop app. It then works in Claude on the web, in the desktop app and in the mobile apps. The Free plan allows one custom connector. On Team and Enterprise plans, an Owner adds it under Organization settings > Connectors.
Claude Code
Run this command in a terminal.
claude mcp add --transport http openhealth https://getopenhealth.org/mcpChatGPT
Go to chatgpt.com/plugins and select the plus button. Select Add custom MCP server. Enter a name and the server address. Choose no authentication and confirm the risk warning. Then select Create as a plugin.
OpenAI's help center lists custom MCP servers for the Pro, Business and Enterprise or Edu plans on ChatGPT on the web only. On Business, Enterprise and Edu plans, an admin or owner adds the server.
Codex
Run this command, or add the lines below to ~/.codex/config.toml. The Codex CLI, the Codex IDE extension and the ChatGPT desktop app share this configuration.
codex mcp add openhealth --url https://getopenhealth.org/mcp[mcp_servers.openhealth]
url = "https://getopenhealth.org/mcp"Cursor
Add this to ~/.cursor/mcp.json to use it in every project, or add it to .cursor/mcp.json to use it in one project.
{
"mcpServers": {
"openhealth": {
"url": "https://getopenhealth.org/mcp"
}
}
}VS Code
Run MCP: Add Server from the Command Palette. Choose HTTP and enter the server address. You can also add this to .vscode/mcp.json in a workspace.
{
"servers": {
"openhealth": {
"type": "http",
"url": "https://getopenhealth.org/mcp"
}
}
}Gemini CLI
Run this command to add the server to the current project. Add --scope user to add it for every project.
gemini mcp add --transport http openhealth https://getopenhealth.org/mcpExample questions
After you connect the server, you can ask questions like these.
- Using OpenHealth, list knee replacement surgeons within 25 miles of Columbus, OH.
- What does Henderson County Community Hospital in Tennessee publish as its price for a head CT without contrast?
- Who owns Summa Health in Akron, Ohio?
- Which public sources does OpenHealth use, and when was each one released?
What the data is and is not
The answers use public CMS and state records. Each figure identifies its source file and date.
A grade describes predicted results for patients at the hospitals affiliated with a doctor. It does not measure the doctor's skill. Doctors affiliated with the same hospitals share a grade. OpenHealth does not give an overall doctor score.
A price is the figure in the hospital's published price file when OpenHealth read it. It is not a personal quote. OpenHealth does not check it against your plan's network, and it is not the total price of your care. OpenHealth does not show a price file older than 30 days.
OpenHealth's ratings predict results from public records. They are not medical advice. OpenHealth does not diagnose a condition, recommend a treatment or replace a clinician's advice.
Confirm current services, locations and insurance coverage with the provider.
Limits and troubleshooting
The server only reads published records. It cannot change a record. It asks for no account, health history or member number.
The server limits the number of lookups it answers each minute. When an assistant reaches the limit, the answer states how many seconds to wait.
A not scored answer means OpenHealth does not rate doctors for that procedure. The answer gives the reason.
An unknown insurance answer means OpenHealth has no directory that lists the doctor for that plan. The result is unknown, not out of network. Ask the plan to confirm.
An unavailable answer means a record did not load. It does not mean the record is empty. Try again later.
If the assistant cannot reach the server, check that the address is exactly https://getopenhealth.org/mcp, with no www and nothing after /mcp.
Email support@getopenhealth.org with questions or problems.
Privacy
The privacy page explains what OpenHealth receives when an assistant uses the server.