Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.tools
Open on GitHub

What 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 1234567890 and show its practice address and status.
  • Use npi_lookup_taxonomy to 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.tools

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 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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open