# mcp-server

Connect an agent to FHIRfly reference data for drugs, clinical codes, and healthcare providers. Useful for looking up identifiers such as NDC, NPI, and ICD-10.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: FHIRfly-io
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FHIRfly-io/fhirfly-mcp-server
- Updated: 2026-09-11
- HTML: https://affpapa.org/en/nevibecode/mcp/fhirfly-io-mcp-server

## What it does

mcp-server gives an agent access to healthcare reference data through the FHIRfly API. Its tools can search medicines and drug interactions, provider records, lab and diagnosis codes, claims information, and FHIR endpoints. Other tools handle UCUM unit lookups and conversions between compatible units.

The server needs Node.js 18+ and a FHIRfly API key supplied as `FHIRFLY_API_KEY`. In Claude Code, add it with `claude mcp add`; the package runs through `npx -y @fhirfly-io/mcp-server`. Requests for reference data require a working API key.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FHIRFLY_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add fhirfly-io-mcp-server --env FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "fhirfly-io-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@fhirfly-io/mcp-server"
            ],
            "env": {
                "FHIRFLY_API_KEY": "<FHIRFLY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "fhirfly-io-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@fhirfly-io/mcp-server"
            ],
            "env": {
                "FHIRFLY_API_KEY": "<FHIRFLY_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> fhirfly-io-mcp-server npx -y @fhirfly-io/mcp-server
```
Replace <…> with your own values

## When to use it
- look up a medicine by NDC or name
- check interactions between several drugs
- find a provider by NPI
- search for a diagnosis or lab code
- convert compatible UCUM units

## Example prompts
- Look up the medicine identified by NDC 0069-0151-01.
- Check whether aspirin interacts with warfarin.
- Convert 100 mg to grams using UCUM.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43902
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md