OMOP Vocabulary API - Query ATHENA Vocabularies Without a Database

OMOPHub provides instant REST API access to OHDSI ATHENA standardized vocabularies - SNOMED CT, ICD-10, RxNorm, LOINC, and 100+ medical terminologies. Search concepts, build mappings, and automate ETL pipelines without setting up a local database.

Working with OMOP vocabularies traditionally requires downloading multi-gigabyte ATHENA files and maintaining a PostgreSQL database. OMOPHub eliminates this overhead:

Perfect for: ETL development, concept set building, phenotype definitions, AI/LLM integration, and any workflow requiring vocabulary access without infrastructure.

Python:

import omophub

# Initialize client (uses OMOPHUB_API_KEY env var)
client = omophub.OMOPHub()

# Search across vocabularies
results = client.search.basic("diabetes mellitus", vocabulary_ids=["SNOMED", "ICD10CM"], standard_concept="S", page_size=10)

# Get concept with relationships
concept = client.concepts.get(201826)  # Type 2 diabetes mellitus

# Map SNOMED concept to ICD-10-CM
mappings = client.mappings.get(201826, target_vocabulary="ICD10CM")

R:

library(omophub)

# Initialize client (uses OMOPHUB_API_KEY env var)
client <- OMOPHubClient$new()

# Search across vocabularies
results <- client$search$basic("diabetes mellitus", vocabulary_ids = c("SNOMED", "ICD10CM"), standard_concept = "S", page_size = 10)

# Map source codes to standard concepts
mappings <- client$mappings$get(201826, target_vocabulary = "ICD10CM")

AI Agents (MCP):

Give Claude, Cursor, or any MCP-compatible AI agent direct access to OMOP vocabularies:

{
  "mcpServers": {
    "omophub": {
      "command": "npx",
      "args": ["-y", "@omophub/omophub-mcp"],
      "env": {
        "OMOPHUB_API_KEY": "oh_your_key_here"
      }
    }
  }
}

Then just ask your AI agent:

"Map ICD-10 code E11.9 to SNOMED"
"Build a concept set for Type 2 diabetes including all descendants"
"What's the OMOP concept ID for metformin?"

Get your API key →

SDK	Package	Repository
Python		omophub-python
R		omophub-R
MCP Server		omophub-mcp

The OMOPHub MCP Server connects Claude, Cursor, VS Code, and any MCP-compatible AI client directly to the full OHDSI vocabulary. No SQL. No database. Just ask.

You: "Map ICD-10 code E11.9 to SNOMED"

Claude: Found it — E11.9 (Type 2 diabetes mellitus without complications)
        maps to SNOMED concept 201826 via standard 'Maps to' relationship.

# Claude Desktop / Cursor / VS Code — add to your MCP config:
npx -y @omophub/omophub-mcp

# Docker
docker run -e OMOPHUB_API_KEY=oh_your_key_here -p 3100:3100 omophub/omophub-mcp

Full setup instructions for Claude Desktop, Cursor, VS Code, and Docker: omophub-mcp →

Access all major medical terminologies synced with official ATHENA releases:

Clinical: SNOMED CT, ICD-10-CM, ICD-10-PCS, ICD-9-CM, Read Codes
Drugs: RxNorm, RxNorm Extension, NDC, ATC, dm+d
Labs: LOINC
Procedures: HCPCS, ICD-10-PCS
Other: MeSH, UCUM, Gender, Race, and 90+ more

Note: Licensed vocabularies (CPT, MedDRA) are not available due to license restrictions.

View versions supported →

• Concept Search - Full-text search with filters by vocabulary, domain, concept class
• Hierarchy Navigation - Traverse ancestors, descendants, and relationships
• Cross-Vocabulary Mappings - Map between ICD-10, SNOMED, RxNorm, and more
• Batch Operations - Process thousands of concepts in single requests
• PHOEBE Support - Recommended concept sets for phenotyping

• < 50ms response time for most queries
• 99.9% uptime with global edge distribution
• Release sync with ATHENA vocabulary releases

• HIPAA & GDPR compliant architecture
• End-to-end encryption for all API traffic
• Immutable audit trails with 7-year retention
• SOC 2 Type II controls

• ETL Development - Look up concepts and validate mappings without database access
• Phenotype Building - Explore hierarchies and build concept sets programmatically
• Clinical Research - Query vocabularies for cohort definitions
• AI/LLM Integration - Ground medical AI models with structured vocabulary data; connect via MCP for agent-native access
• Data Quality - Validate codes and check standard concept mappings

OMOPHub is an independent service - we are not affiliated with OHDSI or ATHENA. We operate on dedicated infrastructure, separate from the official ATHENA vocabulary download service.

While we use the same publicly available OHDSI vocabulary data, OMOPHub is a third-party API built to provide convenient programmatic access without the overhead of local database management.

OMOPHub offers a free plan with 3,000 API calls per month and full API access.

• Issues & Bugs: Open an issue in the relevant SDK repository
• General Questions and Requests: Contact Us

We welcome contributions to our open-source SDKs:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

See individual SDK repositories for contribution guidelines.