Developers
Give any AI medical tools.
OpenMD runs a free MCP server and REST API. One key, eight tools: symptom triage, AI assistant consults, drug-interaction checks, remedies, meal analysis, health-stat reads, the verified-provider directory, and the hospital finder.
1. Get a key (free)
Sign in at openmd.health/account and create an API key — it looks like omd_xxxx_yyyy. Every key includes the fair-use 50 AI calls/week. No card, no subscription.
2. Connect your AI
Claude (claude.ai)
Settings → Connectors → Add custom connector → paste:
https://openmd.health/api/mcp?key=omd_YOUR_KEYClaude Code (CLI)
claude mcp add --transport http openmd https://openmd.health/api/mcp \
--header "Authorization: Bearer omd_YOUR_KEY"ChatGPT
Settings → Connectors (enable developer mode) → add MCP server https://openmd.health/api/mcp?key=omd_YOUR_KEY. Or build a custom GPT Action: import the OpenAPI spec from https://openmd.health/api/v1/openapi.json with Bearer auth.
Gemini CLI
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"openmd": {
"httpUrl": "https://openmd.health/api/mcp",
"headers": { "Authorization": "Bearer omd_YOUR_KEY" }
}
}
}Grok / xAI (and any tool-calling API)
Point function-calling at the REST endpoint — one POST per question:
curl -X POST https://openmd.health/api/v1/ask \
-H "Authorization: Bearer omd_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"question": "What does a low ferritin level mean?"}'Cursor / VS Code / Windsurf
Add to your editor’s mcp.json:
{
"mcpServers": {
"openmd": {
"url": "https://openmd.health/api/mcp",
"headers": { "Authorization": "Bearer omd_YOUR_KEY" }
}
}
}3. The tools your AI gains
openmd_triage_symptoms— urgency triage with red flags and next stepsopenmd_ask_assistant— oath-bound medical Q&Aopenmd_check_drug_interactions— severity-ordered interaction reportsopenmd_find_remedies— OTC/ayurvedic/homeopathic with honest evidence labelsopenmd_analyze_meal— calories, macros, TDEE balance, 3-month projectionopenmd_analyze_health_stats— organ-by-organ digital-twin readopenmd_find_providers— license-verified clinicians with pricing, filterable and paginatedopenmd_find_hospitals— nearby hospitals with ER flags via OpenStreetMap
Protocol notes
- Transport: stateless Streamable HTTP (JSON-RPC 2.0).
GET https://openmd.health/api/mcpreturns server info. - Auth:
Authorization: Bearer,X-API-Key, or?key=for URL-only clients. - Structured outputs: JSON-returning tools include
structuredContentandoutputSchema. - Not a substitute for a licensed clinician. Emergencies → local emergency services, always.