NPI Who MCP
An MCP server that allows AI assistants to look up US healthcare providers by NPI, name, or phone number. It aggregates public federal records including NPPES registry, CMS Open Payments, Medicare billing, OIG exclusions, and facility data to provide detailed provider information and citations.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://npiwho.com/mcpWhat you can do with it
- Look up provider details by NPI number
- Search for healthcare providers by name or state
- Find providers associated with a specific phone number
- List Medicare-certified facilities like hospitals or nursing homes
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- npiwho 1.0.0
- MCP protocol
- 2025-06-18
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
6 advertised
lookup_provider — Look up a provider by NPI
Use when the question names an NPI, or after search_providers has found the right person. One provider by NPI: the registry record, and what the public files have on them (Open Payments total, Medicare billing, OIG exclusion, Medicare clinician record, facility enrollments, claimed-page details) with the page section where each is. The result's url is the page to cite and to send readers to for the detail.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"npi"
],
"properties": {
"npi": {
"type": "string",
"description": "The 10-digit National Provider Identifier"
}
}
}search_providers — Search providers by name
Use when the question names a person or practice but no NPI. Find individual providers or organizations by name, optionally within a state. Returns up to 20 matches, best first, each with its page url. Use lookup_provider on a result for the full record.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"minLength": 2,
"description": "A person's name ('maria gonzalez', 'gonzalez'), or an organization name"
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Two-letter state code, e.g. TX"
}
}
}lookup_phone — Who is at this phone number
Use when the question is who a phone number belongs to. Providers whose registry practice phone, or a phone they published on a claimed page, is this number. Any US format. Providers who asked for their phone to be withheld are not returned.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"phone"
],
"properties": {
"phone": {
"type": "string",
"description": "A US phone number in any format"
}
}
}nearby_providers — Nearest providers of the same specialty
Use when the question is who else does this nearby, or for alternatives to a provider. The providers with the same specialty nearest a given provider (by NPI) or a ZIP code and specialty, by distance between ZIP code centres. Up to 12.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"npi": {
"type": "string",
"description": "Start from this provider's specialty and ZIP"
},
"zip": {
"type": "string",
"description": "Or a 5-digit ZIP code, with taxonomy"
},
"limit": {
"type": "integer",
"maximum": 12,
"minimum": 1
},
"taxonomy": {
"type": "string",
"description": "NUCC taxonomy code, e.g. 207Q00000X for family medicine; required with zip"
}
}
}list_facilities — Facilities in a state
Use when the question is about facilities of a kind in a state or city rather than one named provider. Medicare-certified home health agencies, hospices, hospitals, nursing homes, or HRSA health centers (FQHCs) in a state, optionally one city. Up to 50 rows with page urls; the full list and a CSV are at the state page url.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"kind",
"state"
],
"properties": {
"city": {
"type": "string"
},
"kind": {
"enum": [
"home-health",
"hospice",
"hospital",
"nursing-home",
"health-center"
],
"type": "string"
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"state": {
"type": "string",
"maxLength": 2,
"minLength": 2,
"description": "Two-letter state code"
}
}
}data_sources — Data sources and dates
Use when asked how current or how reliable the data is, or what it does not include. Which public files this data comes from, their snapshot dates, and what they do not cover.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 787 ms
- 95th percentile latency
- 787 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 787 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http npi-who-mcp https://npiwho.com/mcpCodex
codex mcp add npi-who-mcp --url https://npiwho.com/mcpCursor
{
"mcpServers": {
"npi-who-mcp": {
"url": "https://npiwho.com/mcp"
}
}
}Cline
{
"mcpServers": {
"npi-who-mcp": {
"type": "streamableHttp",
"url": "https://npiwho.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"npi-who-mcp": {
"type": "http",
"url": "https://npiwho.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http npi-who-mcp https://npiwho.com/mcpClaude Desktop
{
"mcpServers": {
"npi-who-mcp": {
"url": "https://npiwho.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"npi-who-mcp": {
"serverUrl": "https://npiwho.com/mcp"
}
}
}Let your agent find its tools
Find servers like NPI Who MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.