# npi-providers-mcp-server

npi-providers-mcp-server searches US healthcare providers in NPPES and resolves NUCC specialty codes. Useful for provider lookups by name, location, or specialty.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 275 installs · ★ 1 repo stars
- Author: cyanheads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cyanheads/npi-providers-mcp-server
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/npi-providers-mcp-server

## What it does

This server exposes three tools to an agent. `npi_search_providers` finds individual providers and organizations using names, practice locations, provider type, or specialty. `npi_get_provider` retrieves a professional record from an NPI, while `npi_lookup_taxonomy` resolves, fetches, or browses NUCC taxonomy entries. Plain-language specialties are matched against the bundled taxonomy. Resource-capable clients can also use `npi://provider/{npi}` and `npi://taxonomy/{code}`.

The hosted MCP endpoint is `https://npi-providers-mcp-server--cyanheads.run.tools`. A state-only search is rejected, so include another criterion such as a name, city, postal code, provider type, or specialty. NPI lookups require 10-digit values; the server checks each check digit and separates results into found, absent, failed, and invalid groups.

## Requirements
- Remote server: `https://npi-providers-mcp-server--cyanheads.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add npi-providers-mcp-server --url https://npi-providers-mcp-server--cyanheads.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "npi-providers-mcp-server": {
            "url": "https://npi-providers-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "npi-providers-mcp-server": {
            "type": "http",
            "url": "https://npi-providers-mcp-server--cyanheads.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http npi-providers-mcp-server https://npi-providers-mcp-server--cyanheads.run.tools
```

## When to use it
- find providers by name and location
- match organizations to a specialty
- retrieve a record from an NPI
- resolve a NUCC taxonomy code
- browse NUCC taxonomy groupings

## Example prompts
- Find cardiology providers in California using the NPPES registry.
- Retrieve the record for NPI `1234567890` and show its practice address and status.
- Use `npi_lookup_taxonomy` to resolve this specialty description, then search for matching providers.

## Similar
- [api-platform-state-providers](https://affpapa.org/en/nevibecode/skills/api-platform-state-providers.md) — skill · ★ 234 repo stars
- [taxonomy](https://affpapa.org/en/nevibecode/skills/taxonomy.md) — skill · 65800 installs
- [healthcare-expert](https://affpapa.org/en/nevibecode/skills/healthcare-expert.md) — skill · 443 installs
- [XBRL US Filing Repository](https://affpapa.org/en/nevibecode/mcp/xbrl-us-filing-repository.md) — MCP server · 117 installs
- [FHIR MCP Server](https://affpapa.org/en/nevibecode/mcp/fhir-mcp-server.md) — MCP server · ★ 139 repo stars
- [langcare-mcp-fhir](https://affpapa.org/en/nevibecode/mcp/langcare-mcp-fhir.md) — MCP server · ★ 75 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
