Search NPPES providers and resolve NUCC specialty codes via MCP over STDIO or Streamable HTTP.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fetch the NPPES record for one or more NPI numbers (up to 10 per call). Decodes an NPI from a claim, prescription, or another health data source into the provider's professional-practice profile: every taxonomy with its primary flag, license number and state; practice addresses with phone and fax (only LOCATION rows are kept for individual providers, so their mailing address is withheld; organizations also carry their mailing address); credential, sex, sole-proprietor flag; enumeration and last-updated dates; active/deactivated status; secondary identifiers (Medicaid, etc.); and FHIR/Direct endpoints. Each NPI must be 10 digits with a valid check digit (its last digit); an NPI failing the check digit lands in invalid and is never looked up. Reports partial success: valid NPIs with no registry record (deactivated or never enumerated) land in notFound, while NPIs whose lookup hit an upstream error (registry unavailable, timeout) land in errored — kept distinct from confirmed misses — rather than failing the whole call.
A single 10-digit NPI, or an array of up to 10. Each must be exactly 10 digits; each is also checked against its NPI check digit before any API call, and one that fails is reported in invalid.
Fetch the NPPES record for one or more NPI numbers (up to 10 per call). Decodes an NPI from a claim, prescription, or another health data source into the provider's professional-practice profile: every taxonomy with its primary flag, license number and state; practice addresses with phone and fax (only LOCATION rows are kept for individual providers, so their mailing address is withheld; organizations also carry their mailing address); credential, sex, sole-proprietor flag; enumeration and last-updated dates; active/deactivated status; secondary identifiers (Medicaid, etc.); and FHIR/Direct endpoints. Each NPI must be 10 digits with a valid check digit (its last digit); an NPI failing the check digit lands in invalid and is never looked up. Reports partial success: valid NPIs with no registry record (deactivated or never enumerated) land in notFound, while NPIs whose lookup hit an upstream error (registry unavailable, timeout) land in errored — kept distinct from confirmed misses — rather than failing the whole call.
| Argument | Type | Description |
|---|---|---|
| npis* | any | A single 10-digit NPI, or an array of up to 10. Each must be exactly 10 digits; each is also checked against its NPI check digit before any API call, and one that fails is reported in invalid. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"npis"
],
"properties": {
"npis": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d{10}$",
"description": "A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840)."
},
{
"type": "array",
"items": {
"type": "string",
"pattern": "^\\d{10}$",
"description": "A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840)."
},
"maxItems": 10,
"minItems": 1,
"description": "An array of up to 10 ten-digit NPIs."
}
],
"description": "A single 10-digit NPI, or an array of up to 10. Each must be exactly 10 digits; each is also checked against its NPI check digit before any API call, and one that fails is reported in invalid."
}
},
"additionalProperties": false
}Resolve and browse the NUCC Healthcare Provider Taxonomy — the specialty code set NPPES uses — fully offline (bundled). Mode `resolve` turns a plain-language specialty (e.g. "cardiologist", "heart doctor") into matching active taxonomy entries, excluding codes NUCC marks inactive; mode `get` returns the full entry for an exact code, including NUCC's Notes; mode `browse` walks the hierarchy (grouping → classification → specialization), optionally filtered by grouping and by NPI section (Individual/NPI-1 vs Non-Individual/NPI-2). Every entry carries its status, and an inactive code names its replacement when NUCC gives one; `get` and `browse` still return inactive codes. A resolved entry's specialization, or its classification when specialization is absent, maps directly to npi_search_providers.taxonomy_description.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"mode",
"query"
],
"properties": {
"mode": {
"type": "string",
"const": "resolve",
"description": "Resolve a plain-language specialty to taxonomy codes."
},
"skip": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Entries to skip before the page (0–1000). Keep the same query and limit, then raise skip by limit each call."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Maximum matching entries to return (1–50)."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The plain-language specialty term to resolve, e.g. \"pediatric cardiologist\"."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode",
"code"
],
"properties": {
"code": {
"type": "string",
"minLength": 1,
"description": "The exact NUCC taxonomy code, e.g. \"207RC0000X\"."
},
"mode": {
"type": "string",
"const": "get",
"description": "Fetch one exact taxonomy entry by code."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"mode"
],
"properties": {
"mode": {
"type": "string",
"const": "browse",
"description": "Browse the taxonomy hierarchy."
},
"skip": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Entries to skip before the page (0–1000). Keep the same filters and limit, then raise skip by limit each call."
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Maximum entries to return (1–50)."
},
"section": {
"enum": [
"Individual",
"Non-Individual"
],
"type": "string",
"description": "Filter by NPI section: Individual (NPI-1) or Non-Individual (NPI-2)."
},
"grouping": {
"type": "string",
"description": "Filter to a top-level grouping by case-insensitive substring, e.g. \"physicians\"."
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Search the NPPES NPI registry for individual practitioners and healthcare organizations by name, organization name, location, provider type, and specialty. Plain-language specialty terms (e.g. "cardiologist", "pediatric cardiologist") resolve through the bundled NUCC taxonomy; the top match's specialization or classification becomes taxonomy_description, and all resolved candidates are returned in metadata. Location belongs in the dedicated city/state/postal_code inputs, not inside specialty. Each provider row includes the NPI, name, primary specialty, city/state/ZIP, type, and active/deactivated status; the NPI is the input for npi_get_provider when the full record is needed. At least one search criterion is required, and the registry rejects state-only searches. When city/state/postal_code are given, only practice addresses are searched, never mailing addresses: a provider is returned only when its primary practice location or one of its other practice locations matches all of them. A provider kept on another practice location names it in matchedLocation. Name searches also match former and other names, sorted by current name; such a row names the matching name in matchedOtherName. The registry never reports a true match total, and one search reaches only its first 1200 matches: a full page names the next in nextPage, and the terminal window (skip 1000, limit 200) returns continuationPostalCodes, postal_code prefixes that continue the search.
| Argument | Type | Description |
|---|---|---|
| city | string | Practice-location city, case-insensitive. A trailing "*" after at least 2 characters matches every city starting with them (e.g. "SAN F*"). |
| skip | integer | Results to skip for pagination (0–1000). A full page names the next in nextPage. |
| limit | integer |
| Maximum providers to return (1–200; the registry caps at 200). |
| state | any | 2-letter state code (e.g. "WA"). The registry rejects state-only searches, so another criterion is required. A blank value is treated as omitted. |
| last_name | string | Individual last name. Trailing wildcard "*" allowed with at least 2 leading characters. |
| specialty | string | Plain-language specialty (e.g. "pediatric cardiologist"), resolved through the bundled NUCC taxonomy to exact descriptions before searching. Codes NUCC marks inactive are never resolved. The matched taxonomy is echoed in the result. Mutually exclusive with taxonomy_description. |
| first_name | string | Individual first name. Trailing wildcard "*" allowed with at least 2 leading characters. |
| name_search | string | One person's name. The first token becomes first_name and the last token becomes last_name; use first_name/last_name when middle names or multi-part surnames matter. |
| postal_code | string | Practice-location ZIP code: 5 digits (also matching the ZIP+4 codes that extend it), 9 digits, or a 2–9 digit prefix with one trailing "*" (e.g. "98*", "981*"). A ZIP+4 prefix (6+ digits) never matches a practice address recorded with only a 5-digit ZIP. |
| provider_type | string | Restrict to individuals (NPI-1) or organizations (NPI-2). Omit to search both; when set, it must match the name fields ("individual" for first_name/last_name/name_search, "organization" for organization_name). |
| organization_name | string | Organization name (implies provider_type organization; cannot be combined with first_name, last_name, or name_search). Trailing wildcard "*" allowed with at least 2 leading characters. |
| taxonomy_description | string | Exact NUCC taxonomy description for direct passthrough — use when the taxonomy description is already known. Mutually exclusive with specialty. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"city": {
"type": "string",
"pattern": "^[^*]*$|^[^*]{2,}\\*$",
"description": "Practice-location city, case-insensitive. A trailing \"*\" after at least 2 characters matches every city starting with them (e.g. \"SAN F*\")."
},
"skip": {
"type": "integer",
"default": 0,
"maximum": 1000,
"minimum": 0,
"description": "Results to skip for pagination (0–1000). A full page names the next in nextPage."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 200,
"minimum": 1,
"description": "Maximum providers to return (1–200; the registry caps at 200)."
},
"state": {
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "2-letter state code (e.g. \"WA\")."
}
],
"description": "2-letter state code (e.g. \"WA\"). The registry rejects state-only searches, so another criterion is required. A blank value is treated as omitted."
},
"last_name": {
"type": "string",
"description": "Individual last name. Trailing wildcard \"*\" allowed with at least 2 leading characters."
},
"specialty": {
"type": "string",
"description": "Plain-language specialty (e.g. \"pediatric cardiologist\"), resolved through the bundled NUCC taxonomy to exact descriptions before searching. Codes NUCC marks inactive are never resolved. The matched taxonomy is echoed in the result. Mutually exclusive with taxonomy_description."
},
"first_name": {
"type": "string",
"description": "Individual first name. Trailing wildcard \"*\" allowed with at least 2 leading characters."
},
"name_search": {
"type": "string",
"description": "One person's name. The first token becomes first_name and the last token becomes last_name; use first_name/last_name when middle names or multi-part surnames matter."
},
"postal_code": {
"type": "string",
"pattern": "^[^*]*$|^\\d{2,9}\\*$",
"description": "Practice-location ZIP code: 5 digits (also matching the ZIP+4 codes that extend it), 9 digits, or a 2–9 digit prefix with one trailing \"*\" (e.g. \"98*\", \"981*\"). A ZIP+4 prefix (6+ digits) never matches a practice address recorded with only a 5-digit ZIP."
},
"provider_type": {
"enum": [
"individual",
"organization"
],
"type": "string",
"description": "Restrict to individuals (NPI-1) or organizations (NPI-2). Omit to search both; when set, it must match the name fields (\"individual\" for first_name/last_name/name_search, \"organization\" for organization_name)."
},
"organization_name": {
"type": "string",
"description": "Organization name (implies provider_type organization; cannot be combined with first_name, last_name, or name_search). Trailing wildcard \"*\" allowed with at least 2 leading characters."
},
"taxonomy_description": {
"type": "string",
"description": "Exact NUCC taxonomy description for direct passthrough — use when the taxonomy description is already known. Mutually exclusive with specialty."
}
},
"additionalProperties": false
}