mcp-server · fhirfly-io — Claude Code MCP server for healthcare data
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.
claude mcp add mcp-server -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-serverWhat mcp-server 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.
What it helps with
- 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 for the agent
- Look up the medicine identified by NDC 0069-0151-01.
- Check whether aspirin interacts with warfarin.
- Convert 100 mg to grams using UCUM.
How to install mcp-server
Platform CLI
claude mcp add mcp-server -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add fhirfly-io-mcp-server --env FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-serverReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
gemini mcp add -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> fhirfly-io-mcp-server npx -y @fhirfly-io/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add mcp-server -e FHIRFLY_API_KEY=<FHIRFLY_API_KEY> -- npx -y @fhirfly-io/mcp-server, replacing the placeholder with your FHIRfly key.
What does mcp-server do?
It connects an agent to FHIRfly healthcare reference data, including medicine, provider, and clinical code lookups.
What does mcp-server need to run?
It requires Node.js 18+ and a FHIRfly API key, passed through the FHIRFLY_API_KEY environment variable.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
