npi-providers-mcp-server — Claude Code MCP server: NPI
npi-providers-mcp-server searches US healthcare providers in NPPES and resolves NUCC specialty codes. Useful for provider lookups by name, location, or specialty.
Apache-2.0 275 installs ★ 1 updated 2026-10-09
claude mcp add --transport http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.toolsWhat npi-providers-mcp-server does
This server exposes three tools to an agent. npi_search_providers finds individual providers and organizations using names, practice locations, provider type, or specialty. npi_get_provider retrieves a professional record from an NPI, while npi_lookup_taxonomy resolves, fetches, or browses NUCC taxonomy entries. Plain-language specialties are matched against the bundled taxonomy. Resource-capable clients can also use npi://provider/{npi} and npi://taxonomy/{code}.
The hosted MCP endpoint is https://npi-providers-mcp-server--cyanheads.run.tools. A state-only search is rejected, so include another criterion such as a name, city, postal code, provider type, or specialty. NPI lookups require 10-digit values; the server checks each check digit and separates results into found, absent, failed, and invalid groups.
What it helps with
- find providers by name and location
- match organizations to a specialty
- retrieve a record from an NPI
- resolve a NUCC taxonomy code
- browse NUCC taxonomy groupings
Example prompts for the agent
- Find cardiology providers in California using the NPPES registry.
- Retrieve the record for NPI
1234567890and show its practice address and status. - Use
npi_lookup_taxonomyto resolve this specialty description, then search for matching providers.
How to install npi-providers-mcp-server
Platform CLI: remote server
claude mcp add --transport http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.toolsPlatform CLI: remote server
codex mcp add npi-providers-mcp-server --url https://npi-providers-mcp-server--cyanheads.run.toolsConfig file
{
"mcpServers": {
"npi-providers-mcp-server": {
"url": "https://npi-providers-mcp-server--cyanheads.run.tools"
}
}
}Config file
{
"servers": {
"npi-providers-mcp-server": {
"type": "http",
"url": "https://npi-providers-mcp-server--cyanheads.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.toolsStep 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 npi-providers-mcp-server
How do I install npi-providers-mcp-server in Claude Code?
Run claude mcp add --transport http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.tools.
What does npi-providers-mcp-server do?
It searches the US NPPES registry, retrieves provider records by NPI, and works with NUCC specialty taxonomy data.
What search restrictions should I know about?
A query containing only a state is rejected. Individual-provider criteria cannot be combined with organization criteria, and every search needs at least one criterion.