npi-providers-mcp-server
Search NPPES providers and resolve NUCC specialty codes via MCP over STDIO or Streamable HTTP.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~6,931トークン数（ツール定義）
~28.2 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 5.41%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"npi-providers-mcp-server": {
"command": "bun",
"args": [
"@cyanheads/npi-providers-mcp-server"
]
}
}
}実行可能なパッケージ
npm@cyanheads/npi-providers-mcp-server
0.4.0streamable-httpリモートエンドポイント
https://npi-providers.caseyjhand.com/mcpstreamable-httpできること
ツール一覧
ツール（3）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢npi_search_providers(name_search, first_name, last_name, organization_name, provider_type, ...)
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.
入力スキーマ
{
"type": "object",
"properties": {
"name_search": {
"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.",
"type": "string"
},
"first_name": {
"description": "Individual first name. Trailing wildcard \"*\" allowed with at least 2 leading characters.",
"type": "string"
},
"last_name": {
"description": "Individual last name. Trailing wildcard \"*\" allowed with at least 2 leading characters.",
"type": "string"
},
"organization_name": {
"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.",
"type": "string"
},
"provider_type": {
"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).",
"type": "string",
"enum": [
"individual",
"organization"
]
},
"specialty": {
"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.",
"type": "string"
},
"taxonomy_description": {
"description": "Exact NUCC taxonomy description for direct passthrough — use when the taxonomy description is already known. Mutually exclusive with specialty.",
"type": "string"
},
"city": {
"description": "Practice-location city, case-insensitive. A trailing \"*\" after at least 2 characters matches every city starting with them (e.g. \"SAN F*\").",
"type": "string",
"pattern": "^[^*]*$|^[^*]{2,}\\*$"
},
"state": {
"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.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "2-letter state code (e.g. \"WA\")."
}
]
},
"postal_code": {
"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.",
"type": "string",
"pattern": "^[^*]*$|^\\d{2,9}\\*$"
},
"limit": {
"default": 10,
"description": "Maximum providers to return (1–200; the registry caps at 200).",
"type": "integer",
"minimum": 1,
"maximum": 200
},
"skip": {
"default": 0,
"description": "Results to skip for pagination (0–1000). A full page names the next in nextPage.",
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"providers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "10-digit National Provider Identifier — the chaining key for npi_get_provider."
},
"type": {
"type": "string",
"enum": [
"individual",
"organization"
],
"description": "Provider enumeration type (NPI-1 vs NPI-2)."
},
"name": {
"type": "string",
"description": "Assembled \"First Last\" (individual) or organization name."
},
"credential": {
"description": "Credential (e.g. \"MD\", \"DO\", \"RN\") when present.",
"type": "string"
},
"primaryTaxonomy": {
"description": "The provider's primary taxonomy (the entry flagged primary, else the first listed).",
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Primary taxonomy code."
},
"description": {
"description": "Primary taxonomy description.",
"type": "string"
}
},
"required": [
"code"
],
"additionalProperties": false
},
"city": {
"description": "Primary practice-location city when present.",
"type": "string"
},
"state": {
"description": "Primary practice-location state when present.",
"type": "string"
},
"postalCode": {
"description": "Primary practice-location postal/ZIP code when present.",
"type": "string"
},
"matchedLocation": {
"description": "The additional practice location that satisfied the requested city/state/postal_code. Present only when the primary practice location is elsewhere.",
"type": "object",
"properties": {
"city": {
"description": "City of the matching practice location.",
"type": "string"
},
"state": {
"description": "State of the matching practice location.",
"type": "string"
},
"postalCode": {
"description": "Postal/ZIP code of the matching practice location.",
"type": "string"
}
},
"additionalProperties": false
},
"matchedOtherName": {
"description": "The other (former, professional, DBA, or alternate) name this row matched the name search through. Present only when the current name fails a requested last_name, organization_name, or wildcard first_name and this other name satisfies it (case-insensitive, ignoring punctuation and spaces, trailing \"*\" as a prefix). An exact first_name alone never marks a row: the registry also matches first-name variants (Bob for Robert).",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The other name as \"First Middle Last\", or its organization name."
},
"type": {
"description": "Registry name type, e.g. \"Former Name\", \"Professional Name\".",
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
},
"status": {
"type": "string",
"enum": [
"active",
"deactivated"
],
"description": "Registry status — never treat a deactivated NPI as current."
}
},
"required": [
"npi",
"type",
"name",
"status"
],
"additionalProperties": false,
"description": "A compact provider row for disambiguation."
},
"description": "Matching provider rows (up to limit)."
},
"resolvedTaxonomies": {
"description": "Taxonomy candidates ranked for the specialty term. The first candidate supplies appliedTaxonomyDescription; a different candidate can be selected through taxonomy_description.",
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Resolved NUCC taxonomy code."
},
"description": {
"type": "string",
"description": "Search-compatible NUCC specialization or classification for this candidate."
}
},
"required": [
"code",
"description"
],
"additionalProperties": false
}
},
"appliedTaxonomyDescription": {
"description": "The exact NUCC specialization or classification used as the specialty filter.",
"type": "string"
},
"truncated": {
"description": "True when the NPPES page contained at least cap providers before location constraints were applied; more may match even when shown is below cap.",
"type": "boolean"
},
"shown": {
"description": "Number of providers returned.",
"type": "number"
},
"cap": {
"description": "The limit that was applied.",
"type": "number"
},
"nextPage": {
"description": "The next page: re-run the same arguments with this skip and limit. Present after a full page while rows remain reachable. When skip + limit passes 1000 it is skip 1000, limit 200, whose leading rows repeat rows already returned (the notice says how many) — dedupe by NPI.",
"type": "object",
"properties": {
"skip": {
"type": "number",
"description": "The skip to send for the next page."
},
"limit": {
"type": "number",
"description": "The limit to send for the next page."
}
},
"required": [
"skip",
"limit"
],
"additionalProperties": false
},
"continuationPostalCodes": {
"description": "Present only at the terminal window (a full page at skip 1000, limit 200): postal_code prefixes that continue the same search, each re-run from skip 0 with the same arguments — the notice gives the full procedure. Empty when no postal split remains (postal_code is already a 5-digit ZIP, a full ZIP+4, or not a numeric ZIP prefix).",
"type": "array",
"items": {
"type": "string",
"description": "A trailing-\"*\" postal_code prefix."
}
},
"notice": {
"description": "Guidance — the page-size-not-total caveat, the next page or terminal-window continuation procedure, other-name and location-filter counts, or how to broaden an empty result.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `mixed_provider_criteria`: Individual criteria (first_name, last_name, name_search) were combined with organization criteria (organization_name), directly or through provider_type. `unresolved_specialty`: The specialty term matched no active NUCC taxonomy (the message names any inactive codes it matched), or was made only of generic words (\"doctor\", \"M.D.\", \"specialist\") that name no specialty. `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler.",
"examples": [
"no_search_criteria",
"conflicting_specialty",
"mixed_provider_criteria",
"unresolved_specialty",
"invalid_search_field"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"providers"
]
},
{
"required": [
"error"
]
}
]
}🟢npi_get_provider(npis)
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.
入力スキーマ
{
"type": "object",
"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)."
},
{
"minItems": 1,
"maxItems": 10,
"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)."
},
"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."
}
},
"required": [
"npis"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"found": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "10-digit National Provider Identifier."
},
"type": {
"type": "string",
"enum": [
"individual",
"organization"
],
"description": "Enumeration type (NPI-1 vs NPI-2)."
},
"status": {
"type": "string",
"enum": [
"active",
"deactivated"
],
"description": "Registry status — never treat a deactivated NPI as current."
},
"name": {
"type": "string",
"description": "Assembled \"First Last\" or organization name."
},
"firstName": {
"description": "First name, for individuals.",
"type": "string"
},
"lastName": {
"description": "Last name, for individuals.",
"type": "string"
},
"middleName": {
"description": "Middle name, when present.",
"type": "string"
},
"namePrefix": {
"description": "Name prefix (e.g. \"Dr.\"), when present.",
"type": "string"
},
"nameSuffix": {
"description": "Name suffix (e.g. \"Jr.\"), when present.",
"type": "string"
},
"organizationName": {
"description": "Organization legal name, for organizations.",
"type": "string"
},
"credential": {
"description": "Credential (e.g. \"MD\"), when present.",
"type": "string"
},
"sex": {
"description": "Sex code, for individuals, when present.",
"type": "string"
},
"soleProprietor": {
"description": "Sole-proprietor flag (YES/NO), when present.",
"type": "string"
},
"organizationalSubpart": {
"description": "Organizational subpart flag, for organizations.",
"type": "string"
},
"authorizedOfficial": {
"description": "Authorized official block, for organizations.",
"type": "object",
"properties": {
"firstName": {
"description": "Authorized official first name.",
"type": "string"
},
"lastName": {
"description": "Authorized official last name.",
"type": "string"
},
"middleName": {
"description": "Authorized official middle name.",
"type": "string"
},
"namePrefix": {
"description": "Authorized official name prefix, when present.",
"type": "string"
},
"nameSuffix": {
"description": "Authorized official name suffix, when present.",
"type": "string"
},
"credential": {
"description": "Authorized official credential.",
"type": "string"
},
"title": {
"description": "Authorized official title or position.",
"type": "string"
},
"telephoneNumber": {
"description": "Authorized official telephone number.",
"type": "string"
}
},
"additionalProperties": false
},
"enumerationDate": {
"description": "Date the NPI was enumerated.",
"type": "string"
},
"lastUpdated": {
"description": "Date the record was last updated.",
"type": "string"
},
"certificationDate": {
"description": "Certification date, when present.",
"type": "string"
},
"createdEpoch": {
"description": "Record creation timestamp, epoch milliseconds, when present.",
"type": "number"
},
"lastUpdatedEpoch": {
"description": "Record last-update timestamp, epoch milliseconds, when present.",
"type": "number"
},
"taxonomies": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "Taxonomy code."
},
"description": {
"description": "Taxonomy description.",
"type": "string"
},
"primary": {
"type": "boolean",
"description": "Whether this is the provider's primary taxonomy."
},
"license": {
"description": "License number for this taxonomy, when present.",
"type": "string"
},
"state": {
"description": "License state for this taxonomy, when present.",
"type": "string"
},
"taxonomyGroup": {
"description": "Taxonomy group, when present.",
"type": "string"
}
},
"required": [
"code",
"primary"
],
"additionalProperties": false,
"description": "A taxonomy (specialty) on the record."
},
"description": "All taxonomies (specialties) on the record."
},
"addresses": {
"type": "array",
"items": {
"type": "object",
"properties": {
"purpose": {
"description": "Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING.",
"type": "string"
},
"addressType": {
"description": "Address type (DOM domestic or FOR foreign).",
"type": "string"
},
"line1": {
"description": "Address line 1.",
"type": "string"
},
"line2": {
"description": "Address line 2.",
"type": "string"
},
"city": {
"description": "City.",
"type": "string"
},
"state": {
"description": "State.",
"type": "string"
},
"postalCode": {
"description": "Postal/ZIP code.",
"type": "string"
},
"countryCode": {
"description": "ISO country code.",
"type": "string"
},
"countryName": {
"description": "Country name.",
"type": "string"
},
"telephoneNumber": {
"description": "Telephone number, when present.",
"type": "string"
},
"faxNumber": {
"description": "Fax number, when present.",
"type": "string"
}
},
"additionalProperties": false,
"description": "A practice (LOCATION) address, or an organization mailing address."
},
"description": "Registry addresses. Only LOCATION (practice) rows are kept for individual providers — their mailing address is withheld; organizations carry both LOCATION and MAILING rows."
},
"practiceLocations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"purpose": {
"description": "Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING.",
"type": "string"
},
"addressType": {
"description": "Address type (DOM domestic or FOR foreign).",
"type": "string"
},
"line1": {
"description": "Address line 1.",
"type": "string"
},
"line2": {
"description": "Address line 2.",
"type": "string"
},
"city": {
"description": "City.",
"type": "string"
},
"state": {
"description": "State.",
"type": "string"
},
"postalCode": {
"description": "Postal/ZIP code.",
"type": "string"
},
"countryCode": {
"description": "ISO country code.",
"type": "string"
},
"countryName": {
"description": "Country name.",
"type": "string"
},
"telephoneNumber": {
"description": "Telephone number, when present.",
"type": "string"
},
"faxNumber": {
"description": "Fax number, when present.",
"type": "string"
}
},
"additionalProperties": false,
"description": "A practice (LOCATION) address, or an organization mailing address."
},
"description": "Additional practice locations, when present."
},
"identifiers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"description": "Identifier type code.",
"type": "string"
},
"description": {
"description": "Identifier type description (e.g. \"MEDICAID\").",
"type": "string"
},
"identifier": {
"type": "string",
"description": "The secondary identifier value."
},
"issuer": {
"description": "Issuing organization, when present.",
"type": "string"
},
"state": {
"description": "Associated state, when present.",
"type": "string"
}
},
"required": [
"identifier"
],
"additionalProperties": false,
"description": "A secondary identifier (Medicaid, etc.)."
},
"description": "Secondary identifiers (Medicaid, etc.), when present."
},
"otherNames": {
"type": "array",
"items": {
"type": "object",
"properties": {
"type": {
"description": "Other-name type (former name, DBA, etc.).",
"type": "string"
},
"firstName": {
"description": "First name, for individuals.",
"type": "string"
},
"middleName": {
"description": "Middle name, for individuals, when present.",
"type": "string"
},
"lastName": {
"description": "Last name, for individuals.",
"type": "string"
},
"prefix": {
"description": "Name prefix, when present.",
"type": "string"
},
"suffix": {
"description": "Name suffix, when present.",
"type": "string"
},
"organizationName": {
"description": "Organization name, for organizations.",
"type": "string"
},
"credential": {
"description": "Credential, when present.",
"type": "string"
}
},
"additionalProperties": false,
"description": "A former or alternate name."
},
"description": "Former / alternate names, when present."
},
"endpoints": {
"type": "array",
"items": {
"type": "object",
"properties": {
"endpointType": {
"description": "Endpoint type code (e.g. \"DIRECT\", \"FHIR\").",
"type": "string"
},
"endpointTypeDescription": {
"description": "Endpoint type description.",
"type": "string"
},
"endpoint": {
"type": "string",
"description": "The endpoint URI/address."
},
"endpointDescription": {
"description": "Free-text description of the endpoint (e.g. \"Carequality\"), when present.",
"type": "string"
},
"use": {
"description": "Endpoint use code (e.g. \"HIE\"), when present.",
"type": "string"
},
"useDescription": {
"description": "Endpoint use description, when present.",
"type": "string"
},
"useOtherDescription": {
"description": "What the endpoint is used for when the use code is OTHER, when present.",
"type": "string"
},
"contentType": {
"description": "Endpoint content type code, when present.",
"type": "string"
},
"contentTypeDescription": {
"description": "Endpoint content type description, when present.",
"type": "string"
},
"contentOtherDescription": {
"description": "The content the endpoint carries when the content type is OTHER (e.g. \"C-CDA\"), when present.",
"type": "string"
},
"affiliation": {
"description": "Whether the endpoint is affiliated with an organization (Y/N), when present.",
"type": "string"
},
"affiliationName": {
"description": "Name of the affiliated organization, when present.",
"type": "string"
},
"addressType": {
"description": "Endpoint address type (DOM/FOR), when present.",
"type": "string"
},
"line1": {
"description": "Endpoint address line 1, when present.",
"type": "string"
},
"line2": {
"description": "Endpoint address line 2, when present.",
"type": "string"
},
"city": {
"description": "Endpoint city, when present.",
"type": "string"
},
"state": {
"description": "Endpoint state, when present.",
"type": "string"
},
"postalCode": {
"description": "Endpoint postal/ZIP code, when present.",
"type": "string"
},
"countryCode": {
"description": "Endpoint ISO country code, when present.",
"type": "string"
},
"countryName": {
"description": "Endpoint country name, when present.",
"type": "string"
}
},
"required": [
"endpoint"
],
"additionalProperties": false,
"description": "A FHIR or Direct messaging endpoint with its routing address and context."
},
"description": "FHIR / Direct endpoints, when present."
}
},
"required": [
"npi",
"type",
"status",
"name",
"taxonomies",
"addresses",
"practiceLocations",
"identifiers",
"otherNames",
"endpoints"
],
"additionalProperties": false,
"description": "A decoded NPPES provider record — the registry's professional-practice data. Only LOCATION address rows are kept for individual providers."
},
"description": "Decoded records for NPIs that resolved."
},
"notFound": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "The requested NPI with no record."
},
"reason": {
"type": "string",
"description": "Why it returned nothing (e.g. no registry record)."
}
},
"required": [
"npi",
"reason"
],
"additionalProperties": false,
"description": "A requested NPI that returned no record."
},
"description": "NPIs with a valid check digit that returned no record (deactivated or never enumerated). A confirmed absence, not a failure."
},
"errored": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "The requested NPI whose lookup failed operationally."
},
"reason": {
"type": "string",
"description": "The upstream failure reason (service unavailable, timeout, etc.)."
}
},
"required": [
"npi",
"reason"
],
"additionalProperties": false,
"description": "A requested NPI whose lookup failed with an upstream error."
},
"description": "NPIs whose lookups failed with an upstream/transport error (service unavailable, timeout) — distinct from a confirmed miss in notFound. These are unresolved, not absent; retry them."
},
"invalid": {
"type": "array",
"items": {
"type": "object",
"properties": {
"npi": {
"type": "string",
"description": "The requested NPI that failed the check digit."
},
"reason": {
"type": "string",
"description": "Why the NPI was rejected."
}
},
"required": [
"npi",
"reason"
],
"additionalProperties": false,
"description": "A requested NPI that failed the NPI check digit."
},
"description": "NPIs that failed the NPI check digit — not valid NPIs, usually a typo. They were never looked up, so they are neither confirmed misses nor upstream failures."
},
"totalCount": {
"type": "number",
"description": "Number of provider records that resolved from the requested NPIs."
},
"notice": {
"description": "Guidance when some NPIs failed the check digit, returned no record, or hit an upstream error.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `none_found`: Every requested NPI with a valid check digit returned a confirmed no-record response — none failed with an upstream error (those surface as the underlying service/timeout error instead). `invalid_npi_format`: Every requested NPI failed the NPI check digit, so none was looked up. Other values are possible when a failure originates below the handler.",
"examples": [
"none_found",
"invalid_npi_format"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"found",
"notFound",
"errored",
"invalid",
"totalCount"
]
},
{
"required": [
"error"
]
}
]
}🟢npi_lookup_taxonomy
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.
入力スキーマ
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "resolve",
"description": "Resolve a plain-language specialty to taxonomy codes."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The plain-language specialty term to resolve, e.g. \"pediatric cardiologist\"."
},
"limit": {
"default": 20,
"description": "Maximum matching entries to return (1–50).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"skip": {
"default": 0,
"description": "Entries to skip before the page (0–1000). Keep the same query and limit, then raise skip by limit each call.",
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"required": [
"mode",
"query"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "get",
"description": "Fetch one exact taxonomy entry by code."
},
"code": {
"type": "string",
"minLength": 1,
"description": "The exact NUCC taxonomy code, e.g. \"207RC0000X\"."
}
},
"required": [
"mode",
"code"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"mode": {
"type": "string",
"const": "browse",
"description": "Browse the taxonomy hierarchy."
},
"grouping": {
"description": "Filter to a top-level grouping by case-insensitive substring, e.g. \"physicians\".",
"type": "string"
},
"section": {
"description": "Filter by NPI section: Individual (NPI-1) or Non-Individual (NPI-2).",
"type": "string",
"enum": [
"Individual",
"Non-Individual"
]
},
"limit": {
"default": 20,
"description": "Maximum entries to return (1–50).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"skip": {
"default": 0,
"description": "Entries to skip before the page (0–1000). Keep the same filters and limit, then raise skip by limit each call.",
"type": "integer",
"minimum": 0,
"maximum": 1000
}
},
"required": [
"mode"
],
"additionalProperties": false
}
]
}出力スキーマ
{
"type": "object",
"properties": {
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": "string",
"description": "NUCC taxonomy code, e.g. \"207RC0000X\"."
},
"grouping": {
"type": "string",
"description": "Top-level grouping, e.g. \"Allopathic & Osteopathic Physicians\"."
},
"classification": {
"type": "string",
"description": "Classification within the grouping, e.g. \"Internal Medicine\"."
},
"specialization": {
"description": "Specialization within the classification, e.g. \"Cardiovascular Disease\". Absent for top-level classification codes.",
"type": "string"
},
"displayName": {
"type": "string",
"description": "Human-readable display name, e.g. \"Cardiovascular Disease Physician\"."
},
"definition": {
"description": "Scope note / definition. Absent for a handful of codes.",
"type": "string"
},
"notes": {
"description": "NUCC Notes: sources, revision history, and status remarks. Returned by mode \"get\" only, when NUCC records a note.",
"type": "string"
},
"section": {
"type": "string",
"enum": [
"Individual",
"Non-Individual"
],
"description": "NPI enumeration scope: Individual (NPI-1) or Non-Individual (NPI-2)."
},
"status": {
"type": "string",
"enum": [
"active",
"inactive"
],
"description": "NUCC status. Inactive codes are no longer maintained: mode \"resolve\" excludes them, while \"get\" and \"browse\" return them."
},
"replacedBy": {
"description": "For an inactive code, the active replacement code NUCC names, when it names one.",
"type": "string"
}
},
"required": [
"code",
"grouping",
"classification",
"displayName",
"section",
"status"
],
"additionalProperties": false,
"description": "A single NUCC taxonomy entry."
},
"description": "Matching taxonomy entries. For mode \"get\" this is the single requested entry; for \"resolve\"/\"browse\" it is the ranked/sorted matches up to limit."
},
"truncated": {
"description": "True when the list was capped at `limit` (more entries may match).",
"type": "boolean"
},
"shown": {
"description": "Number of entries returned.",
"type": "number"
},
"cap": {
"description": "The limit that was applied.",
"type": "number"
},
"notice": {
"description": "Guidance — how to page a truncated result with skip, or how to broaden when nothing matched.",
"type": "string"
},
"error": {
"description": "Present when the call failed. Absent on success.",
"type": "object",
"properties": {
"code": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "JSON-RPC error code for this failure."
},
"message": {
"type": "string",
"description": "Human-readable description of what went wrong."
},
"data": {
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Machine-readable failure mode. Declared by this tool: `no_match`: A get code matched no taxonomy entry, a resolve query matched no active one (the message names any inactive codes it matched), or a resolve query was made only of generic words (\"doctor\", \"M.D.\", \"specialist\") that name no specialty. `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler.",
"examples": [
"no_match",
"missing_argument"
]
},
"recovery": {
"description": "Actionable next step for the caller.",
"type": "object",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"additionalProperties": {}
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"additionalProperties": {}
}
},
"required": [
"code",
"message"
],
"additionalProperties": {}
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"matches"
]
},
{
"required": [
"error"
]
}
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 3 件
検証済みバージョンは記録されていませんツール 3 件
検証済みバージョンは記録されていませんツール 3 件