Fhirfly MCP server

@fhirfly-io/mcp-server

MCP (Model Context Protocol) server for connecting Claude Desktop to FHIRfly healthcare reference data APIs.

What is this?

This package lets Claude Desktop look up real healthcare reference data including:

• NDC - Drug products and packages (FDA)
• NPI - Healthcare provider identifiers (CMS)
• RxNorm - Drug terminology (NLM)
• LOINC - Laboratory codes (Regenstrief Institute)
• ICD-10 - Diagnosis and procedure codes (CMS)
• CVX/MVX - Vaccine codes (CDC)
• FDA Drug Labels - Prescribing information
• SNOMED CT - Clinical concepts (IPS free set)
• HCC - CMS Hierarchical Condition Category risk adjustment mappings
• OPCS-4 - UK NHS procedure classification codes
• dm+d - UK Dictionary of Medicines and Devices (NHS)
• UCUM - Unified Code for Units of Measure (NLM)

When you ask Claude about medications, providers, or clinical codes, it can look up accurate, current information instead of relying on training data.

Prerequisites

1. Claude Desktop - Download from claude.ai/download
2. Node.js 18+ - Download from nodejs.org
3. FHIRfly API Key - Get one at fhirfly.io (free tier available)

Quick Setup

Step 1: Get a FHIRfly API Key

1. Go to fhirfly.io and sign up
2. Navigate to Dashboard > Credentials
3. Click Create Credential and select MCP (Claude Desktop)
4. Copy your API key (starts with ffly_)

Step 2: Configure Claude Desktop

Find your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

Add the FHIRfly server configuration:

{
  "mcpServers": {
    "fhirfly": {
      "command": "npx",
      "args": ["-y", "@fhirfly-io/mcp-server"],
      "env": {
        "FHIRFLY_API_KEY": "ffly_live_your_key_here"
      }
    }
  }
}

Replace fflyliveyourkeyhere with your actual API key.

Step 3: Restart Claude Desktop

Completely quit Claude Desktop and reopen it. The FHIRfly tools should now be available.

Verify It Works

Try asking Claude:

• "What is NDC 0069-0151-01?"
• "Look up NPI 1234567893"
• "Search for COVID vaccines in the CVX database"
• "What are the drug interactions for Lipitor?"
• "Which states have implemented Medicaid FHIR endpoints?"
• "Show me the FHIR endpoint details for California's Medicaid program"
• "What is the UCUM code for milligrams per deciliter?"
• "Convert 100 mg to grams"
• "What drugs are in the HMG-CoA Reductase Inhibitors class?"
• "Check interactions between aspirin and warfarin"

Claude should use the FHIRfly tools to look up real data.

Available Tools

Shortened. The full README is on GitHub.