Npi MCP Server

Look up US healthcare providers in the NPPES NPI registry and resolve NUCC specialty codes.

Remote serverstreamable-http

What is the Npi MCP Server?

Look up US healthcare providers in the NPPES NPI registry and resolve NUCC specialty codes.

The short version

  • Declarative tool and resource definitions — single file per primitive, framework handles registration and validation
  • Unified error handling — handlers throw, framework catches, classifies, and formats
  • Pluggable auth: none, jwt, oauth
  • Swappable storage backends: in-memory, filesystem, Supabase, Cloudflare KV/R2/D1
  • Structured logging with optional OpenTelemetry tracing
  • STDIO and Streamable HTTP transports

The tools it exposes

The server publishes 5 tools. What each one is for:

  • npi_search_providers — Search the NPPES registry by name, organization, location, provider type, and specialty. Plain-language specialties resolve through the bundled NUCC
  • npi_get_provider — Fetch the complete NPPES record for up to 10 NPIs — taxonomies, addresses, credentials, identifiers, endpoints, and status
  • npi_lookup_taxonomy — Resolve, fetch, or browse the NUCC Healthcare Provider Taxonomy — fully offline
  • Prerequisites — The Prerequisites tool exposed by this server
  • Installation — The Installation tool exposed by this server

What it needs from you

  • Bun v1.3.2 or higher (or Node.js v24+). - No API key — the NPPES NPI Registry API is public and keyless. The NUCC taxonomy is bundled, so there is no second data source to provision.

Recorded tools

  • npi_search_providers — Search the NPPES registry by name, organization, location, provider type, and specialty. Plain-language specialties resolve through the bundled NUCC taxonomy before searching.
  • npi_get_provider — Fetch the complete NPPES record for up to 10 NPIs — taxonomies, addresses, credentials, identifiers, endpoints, and status.
  • npi_lookup_taxonomy — Resolve, fetch, or browse the NUCC Healthcare Provider Taxonomy — fully offline.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
npi_search_providersSearch the NPPES registry by name, organization, location, provider type, and specialty. Plain-language specialties resolve through the bundled NUCC taxonomy before searching.
npi_get_providerFetch the complete NPPES record for up to 10 NPIs — taxonomies, addresses, credentials, identifiers, endpoints, and status.
npi_lookup_taxonomyResolve, fetch, or browse the NUCC Healthcare Provider Taxonomy — fully offline.

How to install the Npi MCP Server

{
  "mcpServers": {
    "npi-providers-mcp-server": {
      "type": "streamable-http",
      "url": "https://npi-providers.caseyjhand.com/mcp"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Bun v1.3.2 or higher (or Node.js v24+). - No API key — the NPPES NPI Registry API is public and keyless. The NUCC taxonomy is bundled, so there is no second data source to provision.
VariableDescriptionRequired
MCP_TRANSPORT_TYPEConfiguration value read at startup.Optional
MCP_LOG_LEVELConfiguration value read at startup.Optional
NPPES_API_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • “Use Npi to npi search providers.”
  • “Use Npi to npi get provider.”
  • “Use Npi to npi lookup taxonomy.”

Frequently asked questions

Look up US healthcare providers in the NPPES NPI registry and resolve NUCC specialty codes. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.