Skip to main content

​
search_concepts

Search for medical concepts by name or clinical term across all vocabularies.

​
Parameters

ParameterTypeRequiredDescription
querystringYesThe medical term or concept name to search for (1–500 characters)
vocabulary_idsstringComma-separated vocabulary IDs to filter by. Examples: SNOMED, ICD10CM, RxNorm, LOINC
domain_idsstringComma-separated domain IDs to filter by. Examples: Condition, Drug, Measurement, Procedure
standard_conceptstringFilter by standard concept status: S for Standard, C for Classification
pagenumberPage number, 1-based (default: 1)
page_sizenumberResults per page, 1–50 (default: 10)

​
Example

"Search for metformin in RxNorm"
→ search_concepts(query: "metformin", vocabulary_ids: "RxNorm")

​
get_concept

Get detailed information about a specific OMOP concept by its numeric ID.

​
Parameters

ParameterTypeRequiredDescription
concept_idnumberYesThe OMOP concept_id (numeric identifier)

​
Example

"What is concept 201826?"
→ get_concept(concept_id: 201826)

​
get_concept_by_code

Look up a concept using a vocabulary-specific code (e.g., ICD-10 E11.9, SNOMED 44054006).

​
Parameters

ParameterTypeRequiredDescription
vocabulary_idstringYesThe vocabulary system. Examples: ICD10CM, SNOMED, RxNorm, LOINC, CPT4, HCPCS, NDC
concept_codestringYesThe vocabulary-specific code. Examples: E11.9 (ICD-10), 44054006 (SNOMED), 4850 (LOINC)

​
Example

"Look up ICD-10 code E11.9"
→ get_concept_by_code(vocabulary_id: "ICD10CM", concept_code: "E11.9")

​
map_concept

Map a concept to equivalent concepts in other vocabularies (e.g., SNOMED to ICD-10).

​
Parameters

ParameterTypeRequiredDescription
concept_idnumberYesThe source OMOP concept_id to map from
target_vocabulariesstringComma-separated vocabulary IDs to map to. Examples: ICD10CM, SNOMED, RxNorm

​
Example

"Map SNOMED concept 201826 to ICD-10"
→ map_concept(concept_id: 201826, target_vocabularies: "ICD10CM")

​
get_hierarchy

Navigate concept hierarchy — ancestors, descendants, or both.

​
Parameters

ParameterTypeRequiredDescription
concept_idnumberYesThe OMOP concept_id
directionstringup for ancestors, down for descendants, both for full context (default: both)
max_levelsnumberMaximum levels to traverse (default: 5 for up, 10 for down)
max_resultsnumberMaximum nodes to return, 1–500 (default: 500)
vocabulary_idsstringComma-separated vocabulary IDs to filter results

​
Example

"Show me all descendants of Diabetes mellitus"
→ get_hierarchy(concept_id: 201820, direction: "down", max_levels: 3)

​
list_vocabularies

List available medical vocabularies with statistics.

​
Parameters

ParameterTypeRequiredDescription
searchstringOptional search term to filter vocabularies by name

​
Example

"What vocabularies are available?"
→ list_vocabularies()

"Search for drug vocabularies"
→ list_vocabularies(search: "drug")