What the API offers
The API runs the same read-only tools as the MCP server at /mcp. Each tool returns the records OpenHealth publishes on its site, with the source and release of each figure.
Call the tools over MCP with an API key in the Authorization header, or call them as JSON under /api/v1/. The list at /api/v1/tools always shows every tool that is live.
A key never changes a rating, the order of a list or what anyone else sees. Paid and free callers get the same records.
Plans and prices
Each plan sets a number of tool calls each month and a rate each minute. The monthly count resets at 00:00 UTC on the first day of each month.
Annual licences for larger use are priced on request. Email support@getopenhealth.org with the volume and the use you have in mind.
Get a free key
Fill in this form to get a free developer key at once. The next page shows the key one time only, so copy it and keep it safe. OpenHealth sends no email.
OpenHealth uses your name and email only to credit your use and to contact you about the API.
Get a paid key
Choose a plan above to pay through Stripe. After payment, the next page shows your key one time. Copy it and keep it safe.
If you lose the key, open key recovery and enter the receipt number from Stripe's receipt and the email you used at checkout. You get a new key and the old key stops working.
Make a call
Send the key as a bearer token. This JSON call finds doctors for a knee replacement near Columbus, Ohio:
curl https://getopenhealth.org/api/v1/tools/find_doctors_for_procedure \
-H "Authorization: Bearer $OPENHEALTH_KEY" \
-H "Content-Type: application/json" \
-d '{"procedure": "knee-replacement", "place": "Columbus, OH"}'To use the key from an MCP client, add the same Authorization header to the connection settings for https://getopenhealth.org/mcp.
{
"mcpServers": {
"openhealth": {
"url": "https://getopenhealth.org/mcp",
"headers": { "Authorization": "Bearer ohk_live_..." }
}
}
}Limits
- A call over the monthly allowance returns HTTP 429 with the time the count resets.
- A call over the rate for each minute returns HTTP 429 with a
Retry-Afterheader. - Calls with a key share a fixed part of the database with the public MCP server, so the public site always keeps most of its capacity. At a busy time a call can wait or fail. Try again after a short pause.
- Without a key,
/mcpworks as before, with the same limits. The JSON API needs a key.
Terms for the data
- The data comes from public records. Each source keeps its publisher's terms, listed on the sources page.
- Show the source and the release date with any figure you display, and credit OpenHealth.
- Do not resell or redistribute the raw records as a dataset. Build products and analysis on them instead.
- Ratings are predictions from public records. They are not medical advice and they do not guarantee anything about a doctor or a hospital.
- Do not use the data to decide a person's care, coverage or employment without review by a qualified person.
For help, email support@getopenhealth.org or use the contact page. Contact page