Omophub Mcp
by OMOPHubcommunityv1.1.0
4
OMOPHub MCP Server provides instant access to over 10 million OMOP concepts, allowing AI agents to search, map, and navigate medical vocabularies without the need for local database setup.
From the registry: Search, lookup, map, and navigate OMOP medical vocabularies via AI agents
Install & configure
Prerequisites
- requiredOMOPHub API keySign up at omophub.com and create an API key in the dashboard.https://dashboard.omophub.com/api-keys
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `omophub-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **OMOPHub API key** — Sign up at omophub.com and create an API key in the dashboard. (https://dashboard.omophub.com/api-keys)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@omophub/omophub-mcp"]
- required environment variables:
- `OMOPHUB_API_KEY`: OMOPHub API key. (example: `<your-api-key>`)
- optional environment variables:
- `OMOPHUB_BASE_URL`: Custom API base URL. (example: `https://api.omophub.com/v1`)
- `OMOPHUB_LOG_LEVEL`: Log level. (example: `info`)
Note: Hosted alternative at https://mcp.omophub.com (Bearer auth). Docker image defaults to HTTP mode on 3100.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Hosted alternative at https://mcp.omophub.com (Bearer auth). Docker image defaults to HTTP mode on 3100.
Tools (11)
search_concepts
Search for medical concepts by name or clinical term across all vocabularies
get_concept
Get detailed info about a specific OMOP concept by concept_id
get_concept_by_code
Look up a concept using a vocabulary-specific code (e.g., ICD-10 E11.9)
map_concept
Map a concept to equivalent concepts in other vocabularies
get_hierarchy
Navigate concept hierarchy - ancestors, descendants, or both
list_vocabularies
List available medical vocabularies with statistics
semantic_search
Search using natural language with neural embeddings (understands clinical meaning)
find_similar_concepts
Find concepts similar to a reference concept, name, or description
explore_concept
Get concept details, hierarchy, and cross-vocabulary mappings in one call
fhir_resolve
Resolve a FHIR coded value (system URI + code) to its OMOP standard concept and CDM target table
fhir_resolve_codeable_concept
Resolve a FHIR CodeableConcept — picks the best match per OHDSI vocabulary preference
Environment variables
OMOPHUB_API_KEYrequiredYour OMOPHub API keyPackages
@omophub/omophub-mcp
npmv1.1.0transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Mar 5, 2026
- Last commit
- Jun 15, 2026
- Registry name
- io.github.OMOPHub/omophub-mcp