{
  "name": "npi-registry-mcp",
  "title": "HealthMesh · NPI Registry (NPPES) MCP",
  "version": "0.1.0",
  "description": "US provider identifiers from CMS NPPES: live NPI Registry search and full NPI records (taxonomies with licenses, addresses, identifiers, endpoints), plus the full monthly NPPES file (~9.9M NPIs incl. deactivated) for uncapped filtered lists and counts by taxonomy, state, ZIP3 and entity type, NPPES-registered electronic endpoints (Direct, FHIR, SOAP, CONNECT) and the NUCC provider taxonomy code set.",
  "healthmesh_domain": "Provider & Network",
  "datasets": [
    "PROV-01",
    "PROV-02",
    "CODE-10"
  ],
  "mcp_endpoint": "https://npi-registry.healthmesh.ai/mcp",
  "transport": "Streamable HTTP (stateless, JSON responses)",
  "authorization": "none",
  "auth_mode": "off",
  "docs": "https://github.com/HendrikK/healthmesh/tree/main/servers/npi-registry-mcp#readme",
  "contact": "hendrik.kleine@gmail.com",
  "data_source": {
    "name": "CMS NPPES NPI Registry API v2.1 + NPPES monthly Downloadable File V.2 + NUCC provider taxonomy",
    "url": "https://download.cms.gov/nppes/NPI_Files.html",
    "license": "NPPES data: U.S. Government Work (public domain, CMS FOIA-disclosable); NUCC taxonomy: published by NUCC for free use in HIPAA transactions",
    "refresh": "API live (6 h cache); NPPES file monthly via GitHub Actions (blue/green D1)"
  },
  "tools": [
    {
      "name": "npi_search_providers",
      "title": "Search the live NPPES NPI Registry",
      "description": "Searches the live CMS NPPES NPI Registry (active NPIs only) by name, organization, taxonomy description, city, state or postal code; up to 200 matches per call and 1,200 per query via skip (NPPES API caps). Use for finding a specific provider; for complete lists or counts use npi_bulk_search / npi_count_providers. Names accept a trailing * wildcard after at least 2 characters."
    },
    {
      "name": "npi_get_provider",
      "title": "Full NPPES records for one or more NPIs",
      "description": "Returns full NPPES records for 1–50 NPIs from the live registry: all taxonomies (primary flag, license number and state), mailing and practice addresses, secondary practice locations, other identifiers (e.g. Medicaid IDs), other names (DBA), endpoints, enumeration and last-updated dates. NPIs missing from the registry are checked against the monthly file to say whether they were deactivated (with date) or never issued; invalid check digits are flagged."
    },
    {
      "name": "npi_bulk_search",
      "title": "Filter the full NPPES file (no 200-result cap)",
      "description": "Lists NPIs from the full monthly NPPES file (~9.9M NPIs) by NUCC taxonomy code(s), entity type, practice state, ZIP prefix (3–5 digits), enumeration date range and status, with exact total_count where possible. Pages with offset (≤ 10,000). Use for network building and market sizing; use npi_count_providers for counts only and npi_lookup_taxonomy to find codes. Needs at least one of taxonomy_codes, state or zip_prefix."
    },
    {
      "name": "npi_count_providers",
      "title": "Count NPIs by state, ZIP3, taxonomy or entity type",
      "description": "Counts NPIs in the full monthly NPPES file grouped by state, zip3, taxonomy, entity_type or status, optionally filtered by taxonomy codes, entity type, state, ZIP3 and status (default active). Precomputed exact counts; use for supply and density questions (no county: NPPES has no county field)."
    },
    {
      "name": "npi_get_endpoints",
      "title": "Electronic endpoints registered in NPPES",
      "description": "Returns electronic endpoints (Direct messaging addresses, FHIR / REST / SOAP / CONNECT URLs) that providers registered in NPPES, by NPI or by endpoint type, the provider's practice state, taxonomy codes and entity type. Registration is voluntary and often stale, so absence does not mean a provider has no endpoint."
    },
    {
      "name": "npi_lookup_taxonomy",
      "title": "Search the NUCC provider taxonomy code set",
      "description": "Searches the NUCC Health Care Provider Taxonomy (the codes NPPES uses) by keyword, code, grouping or section, returning code, grouping, classification, specialization, display name, definition and how many active NPIs use it in NPPES (primary / any). Use to translate a specialty into codes for npi_bulk_search and npi_count_providers."
    },
    {
      "name": "npi_describe_dataset",
      "title": "What this server covers",
      "description": "Sources, data dates, row counts, coverage rules and caveats for the NPI tools. Lean by default; section='tables' adds per-table row counts and load statistics."
    }
  ]
}