SkillAgentSearch skills...

omop_mcp

Model Context Protocol (MCP) server for mapping clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using Large Language Models

Install / Use

claude mcp add OHNLP -- npx -y github:OHNLP/omop_mcp

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

76/100

Supported Platforms

Claude Code
Claude Desktop

Tags

Our assessment of omop_mcp

omop_mcp scores 76/100 on our quality scale, 43rd of 47 Healthcare & Life Sciences skills we index.

Its MCP Server is 3.4 KB long, well organised into 10 sections with 3 code examples: a solid amount of guidance for an agent.

It has 43 GitHub stars, so there is little community track record yet; judge it on its content.

Substance
26/30
Structure
18/20
Description
15/15
Adoption
7/20
Freshness
11/15

Maintenance, license and trust

  • The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.
  • Our last check on 2026-11-13 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 79/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-11-12. Automated pattern scan on 2026-11-12. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

omop_mcp compared with similar skills

All 4 of these similar skills score higher than omop_mcp; compare them before choosing.

SkillScoreStarsUpdatedFormat
omop_mcp (this skill)by OHNLP76436mo agoMCP Server
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
CowAgentby zhayujie10048.0ktodayCLAUDE.md

Frequently asked questions

How do I install omop_mcp?
Run claude mcp add OHNLP -- npx -y github:OHNLP/omop_mcp. The install tabs above show the steps for each supported agent.
Which AI agents does omop_mcp work with?
It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
Is omop_mcp safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 79/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is omop_mcp still maintained?
The repository was last updated about 6 months ago. That is recent enough to be usable, but agent tooling moves fast, so check the instructions against your agent's current version.

OMOP MCP Server

License arXiv

Model Context Protocol (MCP) server for mapping clinical terminology to Observational Medical Outcomes Partnership (OMOP) concepts using Large Language Models (LLMs). The vocabulary API is supported by OMOP HUB, and you can obtain an API key from omophub.com.

Demo Website

OMapper Screenshot

Overview

This server provides an agentic framework to standardize medical terms into the OMOP Common Data Model (CDM). It uses the OMOPHub API for vocabulary searching, concept suggestion, and terminology mapping.

Installation

Before configuring the MCP server, ensure you have:

  1. uv installed on your system

    • Install from: https://docs.astral.sh/uv/getting-started/installation/
  2. Clone the repository

    git clone https://github.com/OHNLP/omop_mcp.git
    cd omop_mcp
    
  3. Set up environment variables

    Copy .env.template to .env and fill in your API credentials. You will need both an LLM provider key and an OMOPHUB_API_KEY (for vocabulary lookups).

    cp .env.template .env
    

Configuration for Claude Desktop

Add the following configuration to your claude_desktop_config.json file:

Location:

  • MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Configuration:

Replace <path-to-local-repo> with the actual path to your cloned repository.

{
  "mcpServers": {
    "omop_mcp": {
      "command": "uv",
      "args": ["--directory", "<path-to-local-repo>", "run", "omop_mcp"]
    }
  }
}

Features

The OMOP MCP server provides tools and resources for:

  • Mapping clinical terminology: Intelligent mapping of free-text terms to standardized OMOP concepts.
  • Vocabulary Search: Direct access to OMOP vocabulary via find_omop_concept.
  • Batch Processing: Tool for mapping multiple concepts from a CSV file.
  • Preferred Vocabularies: Automatic domain-specific vocabulary prioritization (e.g., LOINC for measurements, SNOMED for conditions).
  • Live Documentation: Resource access to live OMOP CDM documentation.

Usage Example

The agent is most effective when you provide context such as the OMOP table or field name.

Prompt:

Map `Temperature Temporal Scanner - RR` for `measurement_concept_id` in the `measurement` table.

Response Example:

CONCEPT_ID: 46235152
CODE: 75539-7
NAME: Body temperature - Temporal artery
CLASS: Clinical Observation
CONCEPT: Standard
VALIDITY: Valid
DOMAIN: Measurement
VOCAB: LOINC
REASON: This LOINC concept specifically represents body temperature measured at the temporal artery.
URL: https://omophub.com/concepts/46235152

Contributing

See CONTRIBUTING.md for guidelines to contribute to the project.

Citation Policy

If you use this software, please cite the pre-print at arXiv (cs.AI) below:

An Agentic Model Context Protocol Framework for Medical Concept Standardization

License

This project is licensed under the Apache License 2.0. See LICENSE file for details.

Contact: jaerongahn@gmail.com

Related Skills

View on GitHub
GitHub Stars43
CategoryHealthcare
Updated6mo ago
Forks10

Languages

Python

Trust signals

79/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium1 low1 info