Skip to content
MCP server

Npi Registry

MCP server for searching the US CMS NPI Registry of healthcare providers by name, taxonomy

Install
Pricing
Freemium
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About Npi Registry

Npi Registry is a freemium MCP server for health and science. It can run locally on your machine or as a hosted remote server.

The NPI Registry MCP server gives AI clients read access to the CMS National Provider Identifier registry, which covers US healthcare individuals and organizations with an NPI. The main search tool accepts combinations of name, organization, taxonomy, city, state, postal code, NPI type and address purpose, and at least one filter is required. A second tool fetches a single provider by its 10-digit NPI.

The server is a hosted endpoint on the Pipeworx gateway, reachable over streamable HTTP, and an npm package provides a local stdio bridge that forwards calls to the same endpoint. The README notes that the hosted endpoint also lists shared gateway meta-tools such as ask_pipeworx alongside the pack's own tools, while the npm bridge lists only this pack's tools unless configured otherwise.

The server suits developers and analysts building directory lookups, credentialing checks or provider data enrichment who want an agent to query the federal registry without writing their own REST client. Usage without a key is capped daily, and a free Pipeworx account raises the limit.

Install

Run in a terminal

claude mcp add --transport http npi-registry https://gateway.pipeworx.io/npi-registry/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/npi-registry/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "npi-registry": {
      "url": "https://gateway.pipeworx.io/npi-registry/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "npi-registry": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/npi-registry/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "npi-registry": {
      "serverUrl": "https://gateway.pipeworx.io/npi-registry/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "npi-registry": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/npi-registry/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

search
Search NPI Registry providers by number, name, organization, taxonomy, location or NPI type.
get_provider
Look up a provider by 10-digit NPI.

What it does

Multi-field provider search
Searches the registry by any mix of name, organization, taxonomy, location and NPI type, with paging via limit and skip.
Lookup by NPI
Fetches a single provider record directly from a 10-digit National Provider Identifier.
Hosted streamable HTTP endpoint
Connects to a remote MCP endpoint on the Pipeworx gateway without installing anything locally.
Local stdio bridge
An npm package runs the server locally via npx and forwards calls to the hosted endpoint.
Optional API key
A Pipeworx key is optional; without one calls are anonymous and daily-capped, and a free key raises the cap.

Good for

  • Finding a provider's NPI by name and specialty in a given state
  • Verifying that a provider number exists and checking its record
  • Building a healthcare provider directory or enrichment pipeline
  • Letting an AI assistant answer questions about US provider listings

Pricing

Freemium, from $49 a month

Anonymous 50 calls/day; free account 200 calls/day; paid tiers and pay-as-you-go credits available.

Prices change. Check pipeworx.io before you buy.

Npi Registry FAQ

Does the server need an API key?

No. The README and registry entry say calls are anonymous without a key but capped daily; a free Pipeworx key raises the daily cap.

Does a search require any filter?

Yes. The Pipeworx page says the search requires at least one filter such as name, organization, taxonomy, postal code or state.

Which tools does the endpoint expose?

The pack provides a search tool and a get_provider tool for lookup by NPI. The hosted endpoint also lists shared gateway tools such as ask_pipeworx.

Is Npi Registry free?

Npi Registry has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add Npi Registry to Claude Code?

Run this command in your terminal: claude mcp add --transport http npi-registry https://gateway.pipeworx.io/npi-registry/mcp

What are the best alternatives to Npi Registry?

The closest alternatives to Npi Registry are NPPES NPI Registry MCP by usefulapi, SimpleNPI, Medical Codes, NPILayer and NPI Who.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers