OpenMedical API

Build with free medical AI.

OpenMedical exposes its medical tools two ways: a simple REST API for your own apps, and an MCP server that plugs those same tools into Claude, ChatGPT, Gemini, Grok, or any assistant that speaks the Model Context Protocol. Both are free with a fair-use cap — no subscriptions.

OpenMedical provides educational health information, never diagnosis or treatment. Emergencies always route to local emergency services first.

1 · Get an API key

Sign in with Google on the Account page.
Under API keys, create a key — it looks like omd_… and is shown once.
Send it as a bearer token on every request.

Authorization: Bearer omd_your_key_here

2 · Quick start

Ask your first medical question in one request:

curl -X POST https://www.openmedical.health/api/v1/ask \
  -H "Authorization: Bearer omd_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"question": "Can I take ibuprofen with lisinopril?"}'

Response:

{
  "answer": "NSAIDs like ibuprofen can reduce the effect of ACE inhibitors …",
  "disclaimer": "Educational information — not a substitute for a clinician."
}

REST reference

Endpoint	Method	Purpose
`/api/v1/ask`	POST	Medical Q&A — body `{"question": "…"}`
`/api/v1/openapi.json`	GET	Machine-readable OpenAPI spec for codegen

All endpoints require the Authorization: Bearer omd_… header and return JSON. The full schema lives in the OpenAPI spec.

MCP connector

The MCP server gives AI assistants all nine OpenMedical tools at once over Streamable HTTP:

https://www.openmedical.health/api/mcp

Authenticate with the same API key — as a bearer header, or for URL-only clients append it as a query parameter:

https://www.openmedical.health/api/mcp?key=omd_your_key_here

Connect Claude, ChatGPT & more

Claude (claude.ai)

Settings → Connectors → Add custom connector.
Name it OpenMedical and paste the URL with your key: …/api/mcp?key=omd_…
The OpenMedical logo appears once connected; the tools show up in every chat.

Claude Code (CLI)

claude mcp add openmedical \
  --transport http https://www.openmedical.health/api/mcp \
  --header "Authorization: Bearer omd_your_key_here"

ChatGPT / other MCP clients

Anywhere a remote MCP server is accepted, use the same URL and bearer key. The manifest at /.well-known/mcp.json describes the server for auto-discovery.

Available tools

Tool	What it does
`openmedical_triage_symptoms`	Establish urgency for active symptoms — start here.
`openmedical_ask_assistant`	In-depth medical Q&A under the do-no-harm oath.
`openmedical_check_drug_interactions`	Check interactions before combining medications.
`openmedical_find_remedies`	OTC / ayurvedic / homeopathic options with honest evidence labels.
`openmedical_analyze_meal`	Nutrition breakdown of a described meal.
`openmedical_analyze_health_stats`	Digital-twin style read of vitals and stats.
`openmedical_find_providers`	License-verified clinicians for home, clinic, or video visits.
`openmedical_find_hospitals`	Nearby emergency-capable hospitals.
`openmedical_emergency_info`	Ambulance / police / fire numbers for 60+ countries.

Rate limits & pricing

Free: 50 AI calls per week per account — resets every Monday.
Beyond free: load a prepaid wallet on the Account page (from $10 / ₹100), metered per call. No subscriptions.
429 responses mean the weekly cap or wallet is exhausted.

Errors & best practices

Status	Meaning
`401`	Missing or invalid API key.
`429`	Fair-use cap reached — retry after Monday or top up the wallet.
`5xx`	Transient — retry with backoff.

For active symptoms, call openmedical_triage_symptoms first to establish urgency.
Always surface OpenMedical's disclaimer to end users — it is educational information, not medical advice.
Never gate emergency guidance behind your own UI: if triage says emergency, show local emergency numbers immediately.