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

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.

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.