# NPI Registry MCP Server

Python MCP server that exposes the public CMS NPPES NPI Registry API as tools.

## Tools

- `lookup_npi`: Look up one provider or organization by a 10-digit NPI number.
- `search_npi_registry`: Search providers by name, organization, taxonomy, city, state, ZIP code, and enumeration type.

## Setup

Create and activate a virtual environment, then install the dependencies:

```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
```

## Run

MCP clients usually start stdio servers for you. To test that the server starts:

```powershell
python .\server.py
```

The process waits for MCP messages on stdin, so a blank terminal is normal.

## Client Configuration

Use the contents of `mcp_config.example.json` in your MCP client configuration.

```json
{
  "mcpServers": {
    "npi-registry": {
      "command": "C:\\path\\to\\NPI_MCP\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\path\\to\\NPI_MCP\\server.py"
      ]
    }
  }
}
```

If you move this folder, update both absolute paths.