NPI Registry

A Model Context Protocol (MCP) server for searching the National Provider Identifier (NPI) registry. This server provides tools to search and retrieve information about healthcare providers and organizations in the United States.

NPI is a unique identification number for covered health care providers in the United States. This MCP server allows Claude and other MCP-compatible clients to search the official NPI registry maintained by the Centers for Medicare & Medicaid Services (CMS), and integrates the results into an LLM context for enhanced analysis and insights.

- Search by Provider Name: Find individual healthcare providers by first name, last name, or both
- Search by Organization: Look up healthcare organizations by name
- Search by NPI Number: Direct lookup using a specific 10-digit NPI
- Location-based Search: Filter results by city, state, or postal code
- Specialty Search: Find providers by their specialty or taxonomy description
- Comprehensive Data: Returns detailed information including addresses, practice locations, specialties, and other identifiers

- Verify healthcare provider credentials
- Find provider contact information and addresses
- Look up organization details and authorized officials
- Validate NPI numbers
- Research provider specialties and taxonomies
- Find providers in specific geographic areas

- Python 3.10 or higher
- uvpackage manager

git clone https://github.com/eliotk/npi-registry-mcp-server.git cd npi-registry-mcp-server

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"

uv run python -m npi_registry_mcp.server # or using the entry point: uv run npi-registry-mcp-server

uv pip install git+https://github.com/eliotk/npi-registry-mcp-server.git

Search the NPI registry with various criteria:

- first_name(optional): Provider's first name
- last_name(optional): Provider's last name
- organization_name(optional): Organization name
- npi(optional): Specific 10-digit NPI number
- city(optional): City name
- state(optional): State abbreviation (e.g., 'CA', 'NY')
- postal_code(optional): ZIP/postal code (supports wildcards)
- specialty(optional): Provider specialty or taxonomy
- limit(optional): Maximum results to return (1-200, default: 10)

# Search for a specific provider by name search_npi_registry(first_name="John", last_name="Smith", state="CA") # Look up a specific NPI search_npi_registry(npi="1234567890") # Find organizations in a city search_npi_registry(organization_name="Hospital", city="Los Angeles", state="CA") # Search by specialty search_npi_registry(specialty="cardiology", state="NY", limit=20) # Find providers in a specific ZIP code area search_npi_registry(postal_code="902*", state="CA")

The search returns a structured response with:

{ "success": true, "count": 5, "results": [ { "npi": "1234567890", "entity_type": "Individual", "is_organization": false, "status": "A", "enumeration_date": "2010-05-05", "last_updated": "2023-01-15", "name": { "first": "John", "last": "Smith", "credential": "MD" }, "addresses": [...], "practice_locations": [...], "taxonomies": [...], "identifiers": [...] } ] }

To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file:

Location:~/Library/Application Support/Claude/claude_desktop_config.json

Location:%APPDATA%/Claude/claude_desktop_config.json

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

- Save the configuration file
- Restart Claude Desktop completely
- Look for the 🔧 icon in Claude Desktop to verify the server is connected
- Try asking Claude: "Search for doctors named Smith in California"

npi-registry-mcp-server/ ├── src/ │ └── npi_registry_mcp/ │ ├── __init__.py │ └── server.py ├── tests/ ├── pyproject.toml ├── README.md └── .gitignore

# Format code uv run black src/ tests/ # Sort imports uv run isort src/ tests/ # Lint uv run ruff check src/ tests/ # Type checking uv run mypy src/

This server uses the official NPI Registry API provided by CMS:

- Base URL:https://npiregistry.cms.hhs.gov/api/
- Documentation:https://npiregistry.cms.hhs.gov/registry/help-api
- Rate Limits: The API has reasonable rate limits for normal usage

For more information about the Model Context Protocol, visit:https://modelcontextprotocol.io/

Find and book doctor, dentist & nurse appointments. 2M+ providers by insurance & cost in the US.