NPI Registry MCP Server 🏥
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.
Overview 📋
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.
Features ✨
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
Use Cases 💡
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
Installation 🚀
Prerequisites 📋
Python 3.10 or higher
uv package manager
Development Setup 🛠️
Clone the repository:
git clone https://github.com/eliotk/npi-registry-mcp-server.git cd npi-registry-mcp-serverInstall uv (if not already installed):
curl -LsSf https://astral.sh/uv/install.sh | shCreate a virtual environment and install dependencies:
uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate uv pip install -e ".[dev]"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
Production Installation 🌟
Install from PyPI (once published):
Or install from source:
Usage 📚
Available Tools 🛠️
search_npi_registry
🔎
Search the NPI registry with various criteria:
Parameters:
first_name
(optional): Provider's first namelast_name
(optional): Provider's last nameorganization_name
(optional): Organization namenpi
(optional): Specific 10-digit NPI numbercity
(optional): City namestate
(optional): State abbreviation (e.g., 'CA', 'NY')postal_code
(optional): ZIP/postal code (supports wildcards)specialty
(optional): Provider specialty or taxonomylimit
(optional): Maximum results to return (1-200, default: 10)
Examples:
Response Format 📄
The search returns a structured response with:
Claude Desktop Configuration 🖥️
To use this MCP server with Claude Desktop, add the following configuration to your Claude Desktop config file:
macOS 🍎
Location: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows 🪟
Location: %APPDATA%/Claude/claude_desktop_config.json
Configuration 📝
Verification ✅
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"
Development 👨💻
Project Structure 📁
Running Tests 🧪
Code Formatting 🎨
Building the Package 📦
API Reference 📖
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
Data Sources 🗃️
All data comes directly from the official NPI Registry maintained by:
Centers for Medicare & Medicaid Services (CMS)
U.S. Department of Health and Human Services
Contributing 🤝
Fork the repository
Create a feature branch:
git checkout -b feature-name
Make your changes and add tests
Run the test suite:
uv run pytest
Format your code:
uv run black src/ tests/
Submit a pull request
License 📄
MIT License - see LICENSE file for details.
Support 🆘
Issues: Report bugs and request features via GitHub Issues
Documentation: Additional documentation available in the
/docs
directoryAPI Questions: Refer to the official NPI Registry API documentation
Changelog 📝
v0.1.0 🎉
Initial release
Basic NPI registry search functionality
Support for individual and organization searches
Location and specialty filtering
Comprehensive provider data retrieval
For more information about the Model Context Protocol, visit: https://modelcontextprotocol.io/
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
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.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that provides search and crawl functionality using Search1API.Last updated -100156MIT License
- AsecurityAlicenseAqualityA Model Context Protocol (MCP) server for querying the CVE-Search API. This server provides comprehensive access to CVE-Search, browse vendor and product、get CVE per CVE-ID、get the last updated CVEs.Last updated -653MIT License
- AsecurityFlicenseAqualityA Model Context Protocol (MCP) server that interacts with system APIs, allowing users to check connections, search employees, register breakfast, and update chemical information by shifts.
- AsecurityAlicenseAqualityAn MCP server that allows searching for and retrieving information about Model Context Protocol servers registered on the MCP Hub.Last updated -11MIT License