NPI

You set up and use an MCP server that lets clients search the National Provider Identifier (NPI) registry. It provides fast, structured access to provider and organization data from CMS, enabling you to verify credentials, locate contact information, and explore provider taxonomies and locations through an MCP client.

How to use

You interact with the NPI MCP server through an MCP-compatible client. Start the local MCP server using your preferred runtime command, then issue search requests to fetch providers, organizations, or specific NPIs. Use practical search criteria to refine results: provider names, organization names, NPI numbers, cities, states, postal codes, and specialties. The server returns detailed results that include identifiers, addresses, practice locations, and taxonomies, making it easy to verify credentials, locate offices, or research provider specialties.

How to install

Prerequisites: Python 3.10 or higher and the uv package manager.

# Step 1: Clone the repository
git clone https://github.com/eliotk/npi-registry-mcp-server.git
cd npi-registry-mcp-server

# Step 2: Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Step 3: Create a virtual environment and install dependencies
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

# Step 4: Run the server directly for testing
uv run python -m npi_registry_mcp.server
# or using the entry point
uv run npi-registry-mcp-server

Additional sections

Configuration and runtime details are provided to help you connect clients and keep data secure. The MCP server uses the official NPI Registry API to fetch provider data, including names, addresses, practice locations, taxonomies, and identifiers.

Claude Desktop users can connect to the local MCP server by configuring the client to launch the server process and point to its directory. Use the following example to integrate the MCP server with Claude Desktop.

{
  "mcpServers": {
    "npi-registry": {
      "command": "uv", # may need full path to executable
      "args": [
        "--directory",
        "/path/to/npi-registry-mcp-server",
        "run",
        "npi-registry-mcp-server"
      ]
    }
  }
}

Available tools

search_npi_registry

Searches the NPI registry by provider name, organization, NPI number, location, or specialty and returns detailed provider data including addresses, practice locations, and taxonomies.