# Healthparse Healthcare Data Gateway (remote · api.healthparse.io)

Pay-per-call US healthcare data: hospital financials, prices, quality, exclusions, wages.

- Trust score: 67/100 (medium)
- Change this week: +8
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `api.healthparse.io`: 67/100 (this document), [markdown](https://verifymcp.io/servers/io-healthparse-gateway/api.md), [page](https://verifymcp.io/servers/io-healthparse-gateway/api)

## Channel facts

- Endpoint: `https://api.healthparse.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 40 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7185 tokens (~179/item across 40 items; 40 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 81/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 43% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http io-healthparse-gateway https://api.healthparse.io/mcp
```

### Codex

```toml
[mcp_servers.io-healthparse-gateway]
url = "https://api.healthparse.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-healthparse-gateway": {
      "type": "remote",
      "url": "https://api.healthparse.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-healthparse-gateway --url https://api.healthparse.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-healthparse-gateway:
    url: "https://api.healthparse.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-healthparse-gateway": {
      "type": "http",
      "url": "https://api.healthparse.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 66, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 63, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 61, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 13. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 60, +1)

- [functional regression] Schema quality: 150 → 176
- [functional improvement] Tool coverage: 32% → 41%

### 2026-07-27 (score 59, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 59)

First indexed and scored.

## MCP tools (40)

### `hcris_hospital_search` (~222 tokens)

Search US hospitals by state, city, type, control, beds, discharges, revenues, or operating margin. Answers: which hospitals in a market match a financial or operational profile? Source: CMS cost reports (HCRIS 2552-10). [price: $0.02/call]

Input parameters:

- `city` (string)
- `control_type` (string)
- `fy_end_year` (integer)
- `hospital_type` (string)
- `limit` (integer)
- `name_search` (string)
- `offset` (integer)
- `operating_margin_max` (number)
- `operating_margin_min` (number)
- `state` (string)
- `total_beds_max` (number)
- `total_beds_min` (number)
- `total_discharges_max` (number)
- `total_discharges_min` (number)
- `total_revenues_max` (number)
- `total_revenues_min` (number)
- `zip_prefix` (string)

### `hcris_hospital_byCcn` (~81 tokens)

Hospital cost-report record by CMS Certification Number (CCN). Answers: what are the financial and operational metrics for this hospital across fiscal years? Includes identity, beds, discharges, revenues, net income, operating margin. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `hcris_asc_search` (~94 tokens)

Search ambulatory surgical centers (ASCs) by state, CCN, or name. Answers: which ASCs are in a given market? Source: CMS ASC cost data. [price: $0.02/call]

Input parameters:

- `ccn` (string)
- `limit` (integer)
- `name_search` (string)
- `offset` (integer)
- `state` (string)

### `hcris_provider_search` (~158 tokens)

Search Medicare providers by NPI, state, specialty, service volume, beneficiaries, or payments. Answers: which providers in a market match this specialty, volume, or beneficiary profile? Source: CMS Medicare claims. [price: $0.02/call]

Input parameters:

- `limit` (integer)
- `npi` (string)
- `offset` (integer)
- `specialty` (string)
- `state` (string)
- `total_beneficiaries_max` (number)
- `total_beneficiaries_min` (number)
- `total_payment_max` (number)
- `total_payment_min` (number)
- `total_services_max` (number)
- `total_services_min` (number)

### `irs990_org_search` (~136 tokens)

Search nonprofit health organizations by state, NTEE code, revenue or expense range, or name. Answers: which nonprofit hospitals/health orgs match this financial profile? Source: IRS Form 990 e-filings. [price: $0.02/call]

Input parameters:

- `limit` (integer)
- `name_search` (string)
- `net_income_max` (number)
- `net_income_min` (number)
- `ntee_code` (string)
- `offset` (integer)
- `revenue_max` (number)
- `revenue_min` (number)
- `state` (string)

### `irs990_org_byEin` (~79 tokens)

Nonprofit health organization Form 990 filing history by EIN. Answers: what are the revenues, expenses, and trends for this nonprofit across fiscal years? Source: IRS Form 990 e-filings. [price: $0.01/call]

Input parameters:

- `ein` (string, required): Path parameter: IRS Employer Identification Number (EIN)

### `irs990_officers_search` (~119 tokens)

Search nonprofit hospital executive compensation: officers and key employees by organization (EIN), name, or compensation range. Answers: who are the executives at this nonprofit health org and what do they earn? Source: IRS Form 990 Schedule J. [price: $0.02/call]

Input parameters:

- `ein` (string)
- `limit` (integer)
- `name_search` (string)
- `offset` (integer)
- `total_compensation_max` (number)
- `total_compensation_min` (number)

### `sanctions_leie_search` (~116 tokens)

Search the OIG List of Excluded Individuals/Entities (LEIE) by name, NPI, state, or exclusion type. Answers: is this provider excluded from federal healthcare programs? Monthly refresh. [price: $0.03/call]

Input parameters:

- `business_name_search` (string)
- `exclusion_type` (string)
- `last_name_search` (string)
- `limit` (integer)
- `npi` (string)
- `offset` (integer)
- `state` (string)

### `oews_wage_search` (~121 tokens)

Healthcare wage benchmarks by SOC occupation and area (national, state, metro): median, mean, and P25–P90 percentiles plus employment. Answers: what does this role pay in this market? Source: BLS OEWS. [price: $0.02/call]

Input parameters:

- `area_code` (string)
- `area_type` (string)
- `limit` (integer)
- `occupation_code` (string)
- `offset` (integer)
- `state` (string)
- `year` (integer)

### `carecompare_hospitals_search` (~112 tokens)

Search hospitals quality data by state, city, ZIP, or CMS star rating. Answers: which hospitals meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]

Input parameters:

- `city` (string)
- `limit` (integer)
- `offset` (integer)
- `overall_rating_max` (number)
- `overall_rating_min` (number)
- `state` (string)
- `zip_prefix` (string)

### `carecompare_hospitals_byCcn` (~70 tokens)

CMS Care Compare quality record by CCN for a hospitals. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `carecompare_snf_search` (~113 tokens)

Search snf quality data by state, city, ZIP, or CMS star rating. Answers: which snf meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]

Input parameters:

- `city` (string)
- `limit` (integer)
- `offset` (integer)
- `overall_rating_max` (number)
- `overall_rating_min` (number)
- `state` (string)
- `zip_prefix` (string)

### `carecompare_snf_byCcn` (~70 tokens)

CMS Care Compare quality record by CCN for a snf. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `carecompare_home-health_search` (~111 tokens)

Search home health quality data by state, city, ZIP, or CMS star rating. Answers: which home health meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]

Input parameters:

- `city` (string)
- `limit` (integer)
- `offset` (integer)
- `rating_max` (number)
- `rating_min` (number)
- `state` (string)
- `zip_prefix` (string)

### `carecompare_home-health_byCcn` (~70 tokens)

CMS Care Compare quality record by CCN for a home health. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `carecompare_hospice_search` (~110 tokens)

Search hospice quality data by state, city, ZIP, or CMS star rating. Answers: which hospice meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]

Input parameters:

- `city` (string)
- `limit` (integer)
- `offset` (integer)
- `rating_max` (number)
- `rating_min` (number)
- `state` (string)
- `zip_prefix` (string)

### `carecompare_hospice_byCcn` (~70 tokens)

CMS Care Compare quality record by CCN for a hospice. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `carecompare_dialysis_search` (~110 tokens)

Search dialysis quality data by state, city, ZIP, or CMS star rating. Answers: which dialysis meet quality thresholds in a market? Source: CMS Care Compare, monthly refresh. [price: $0.02/call]

Input parameters:

- `city` (string)
- `limit` (integer)
- `offset` (integer)
- `rating_max` (number)
- `rating_min` (number)
- `state` (string)
- `zip_prefix` (string)

### `carecompare_dialysis_byCcn` (~70 tokens)

CMS Care Compare quality record by CCN for a dialysis. Answers: what are the quality ratings and performance measures for this facility? Source: CMS Care Compare. [price: $0.01/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `hpt_rates_search` (~138 tokens)

Search hospital price-transparency negotiated rates by billing code (CPT/HCPCS/MS-DRG), state, payer, hospital CCN, or rate type. Answers: what do payers actually pay for this procedure at these hospitals? Source: hospital-published MRFs. [price: $0.03/call]

Input parameters:

- `billing_code` (string)
- `billing_code_type` (string)
- `ccn` (string)
- `limit` (integer)
- `offset` (integer)
- `payer` (string)
- `rate_type` (string)
- `state` (string)

### `sanctions_screen` (~150 tokens)

Screen a provider (name and/or NPI) against all federal and state exclusion lists in one call — OIG LEIE, GSA SAM, OFAC SDN, FDA debarment, state Medicaid exclusions, and licensing-board sanctions from 13 states. Returns an attested clear/flagged verdict with per-list counts. NPI-only screens (no name) cover 4 of 6 lists — OFAC SDN and FDA debarment need a name; see lists_checked/lists_not_applicable. For hiring, credentialing, and vendor-onboarding agents. [price: $0.15/call]

Input parameters:

- `name` (string)
- `npi` (string)

### `hpt_code_stats` (~141 tokens)

National price statistics for a billing code (CPT/HCPCS/MS-DRG) from hospital price-transparency files: median and spread of payer-negotiated rates. Answers: what is a fair price for this procedure? Shape varies: a code under one billing_code_type (common case) returns the flat row shown below; a code ambiguous across types instead returns { billing_code, stats_by_type: [...] } — check for a top-level stats_by_type array to tell them apart. [price: $0.005/call]

Input parameters:

- `code` (string, required): Path parameter: billing code (CPT/HCPCS/MS-DRG)

### `hcris_hospital_financials` (~73 tokens)

Multi-year financial history for one hospital by CCN: beds, discharges, revenues, net income per fiscal year, up to 15 years. Source: CMS cost reports. [price: $0.05/call]

Input parameters:

- `ccn` (string, required): Path parameter: CMS Certification Number

### `providers_events_feed` (~254 tokens)

Provider change-event feed over 7 federal sources: new NPI enumerations, newly billing Medicare, enrollment pending, address changes, deactivations, CLIA lab certificates, ownership changes (CHOW), mammography facility cert changes, and hospital capex jumps. Answers: what changed in my territory since I last looked? Filter by type (comma-separated), state, since (YYYY-MM-DD), npi, ccn; page via next_cursor (keyset). 85k+ events, refreshed twice-weekly to quarterly by source. [price: $0.1/call]

Input parameters:

- `ccn` (string)
- `cursor` (string): opaque next_cursor from the previous page
- `limit` (integer)
- `npi` (string)
- `since` (string): only events on/after this date (YYYY-MM-DD)
- `state` (string): 2-letter state code(s), comma-separated
- `type` (string): comma-separated event types: enrollment_pending, newly_billing, new_enumeration, address_change, deactivation, new_lab_certificate, lab_cert_upgrade, ownership_change, new_mammo_facility, mammo_decer…

### `hospitals_capex_signals` (~187 tokens)

Hospital capital-expenditure jump signals from CMS cost reports (Worksheet A-7): hospitals whose major movable equipment purchases hit at least $1M and at least 2x the prior fiscal year — an observational marker that a hospital reported a step-up in equipment spend. Answers: which hospitals just bought equipment? Includes purchase dollars by asset class and the prior-year comparison. Filter by state, min_amount (movable-equipment dollars), since; keyset cursor pagination. [price: $0.1/call]

Input parameters:

- `cursor` (string): opaque next_cursor from the previous page
- `limit` (integer)
- `min_amount` (number): minimum movable-equipment purchase dollars in the trigger year
- `since` (string): only events on/after this date (YYYY-MM-DD)
- `state` (string): 2-letter state code(s), comma-separated

### `providers_provider360` (~137 tokens)

One-call dossier of everything Healthparse knows about a provider NPI: NPPES identity, taxonomy and practice address; Medicare ordering-and-referring privileges; NPI exclusion screen (OIG LEIE, GSA SAM, state Medicaid, state boards); change-event history; Medicare Part B utilization and Part D prescribing summaries; Open Payments totals by year; hospital affiliations with star ratings; MIPS quality scores. Absent legs say so explicitly. Records as filed; not a consumer report. [price: $0.25/call]

Input parameters:

- `npi` (string, required): Path parameter: 10-digit National Provider Identifier (NPI)

### `manufacturers_search` (~294 tokens)

Discover pharma & device MANUFACTURERS from CMS Open Payments by name, total-spend band, or year of first appearance — the emerging/small-brand filter (low total_spend and/or recent first_seen_year) plus optional specialty/state activity. Answers: which small or new manufacturers pay physicians in my category and territory? Entity-resolved company dimension (DBA/subsidiary variants merged). Filter: name, max_total_spend, first_seen_year_min/max, specialty, state. [price: $0.03/call]

Input parameters:

- `first_seen_year_max` (integer)
- `first_seen_year_min` (integer): manufacturers first appearing in/after this program year
- `limit` (integer)
- `max_total_spend` (number): only manufacturers whose all-time reported spend is ≤ this (small/emerging)
- `min_total_spend` (number)
- `name` (string): case-insensitive substring of the manufacturer name
- `offset` (integer)
- `performance_year` (integer)
- `sort` (string): total_spend|first_seen_year|physician_engagements|distinct_specialties|display_name, optionally :asc/:desc
- `specialty` (string): Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease', 'Hematology & Oncology'
- `state` (string): 2-letter recipient state code(s), comma-separated

### `manufacturers_openPayments` (~268 tokens)

Which manufacturers pay a given physician specialty in a territory, and how much — CMS Open Payments rolled up to the paying company. Answers: which pharma/device companies already reach cardiologists in Texas, and which are the small/emerging ones (max_total_spend) to partner with or compete against? Filter: specialty, state, performance_year (defaults to latest), max_total_spend/min_total_spend, min_physicians; sort by matched_amount or manufacturer_total_spend (asc = smallest first). [price: $0.03/call]

Input parameters:

- `limit` (integer)
- `max_total_spend` (number): only manufacturers whose all-time reported spend is ≤ this (small/emerging)
- `min_physicians` (number): minimum matched physician×specialty×state relationships
- `min_total_spend` (number)
- `offset` (integer)
- `performance_year` (integer): program year; defaults to the latest loaded
- `sort` (string): matched_amount|manufacturer_total_spend|first_seen_year|matched_physician_cells, optionally :asc/:desc
- `specialty` (string): Open Payments recipient specialty leaf, e.g. 'Cardiovascular Disease'
- `state` (string): 2-letter recipient state code(s), comma-separated

### `hrsa_healthCenters_search` (~301 tokens)

Discover FQHC / Look-Alike health-center SITES from the HRSA roster by state, type, county, name, or newly-added-to-scope date (added_since = new-site trigger). Answers: which FQHC sites exist in my territory, and which are new? Each site is entity-resolved into NPPES (matched_npi / match_method). Powers pharma-sales 340B, medical-device, and medical/travel-nurse staffing targeting. Filter: state, health_center_type, status, name, county, added_since, resolved_only. [price: $0.03/call]

Input parameters:

- `added_since` (string): sites added to scope on/after this date (YYYY-MM-DD) — new-site trigger
- `county` (string): county name substring
- `health_center_type` (string): substring, e.g. 'FQHC' or 'Look-Alike'
- `limit` (integer)
- `name` (string): case-insensitive substring of the site name
- `offset` (integer)
- `resolved_only` (boolean): only sites resolved into the NPPES graph (matched_npi present)
- `sort` (string): site_added_to_scope|site_name|site_state, optionally :asc/:desc
- `state` (string): 2-letter state code(s), comma-separated
- `status` (string): site status, e.g. 'Active'

### `hrsa_hpsa_search` (~299 tokens)

Find HRSA Health Professional Shortage Areas (Primary Care / Dental / Mental Health) by state, discipline, minimum shortage score, or FTE shortage — a mapped staffing-demand signal. Answers: where is the designated shortage most severe, and how many practitioner FTEs are needed? Powers medical & travel-nurse staffing. Defaults to currently-designated areas. Filter: state, discipline, min_score, min_fte, rural_status, designated_since, status; sort by hpsa_score or hpsa_fte. [price: $0.03/call]

Input parameters:

- `designated_since` (string): designated on/after this date (YYYY-MM-DD)
- `discipline` (string): 'Primary Care' | 'Dental Health' | 'Mental Health' (substring)
- `limit` (integer)
- `min_fte` (number): minimum practitioner FTE shortage
- `min_score` (number): minimum HPSA score (0-26; higher = greater shortage)
- `offset` (integer)
- `rural_status` (string): e.g. 'Rural' | 'Non-Rural'
- `sort` (string): hpsa_score|hpsa_fte|designation_date|designation_population, optionally :asc/:desc
- `state` (string): 2-letter state code(s), comma-separated
- `status` (string): override the default 'Designated' filter

### `hrsa_coveredEntities340b_search` (~249 tokens)

Search HRSA 340B OPAIS covered entities + child sites by state, entity type (FQHC/DSH/CAH/RHC/…), or name — the 340B buyer/pharmacy roster. Answers: which 340B-eligible entities operate in my territory, and which have an NPI to join into the provider graph? Powers pharma-sales (340B pharmacies) targeting. Filter: state, entity_type, name, has_npi, parents_only. [price: $0.03/call]

Input parameters:

- `entity_type` (string): HRSA entity type code(s), comma-separated, e.g. 'FQHC,DSH,CAH'
- `has_npi` (boolean): only entities with a published NPI
- `limit` (integer)
- `name` (string): case-insensitive substring of the entity name
- `offset` (integer)
- `parents_only` (boolean): only parent covered entities (exclude child sites)
- `sort` (string): name|active_since|state, optionally :asc/:desc
- `state` (string): 2-letter state code(s), comma-separated

### `nppes_enumeration_search` (~293 tokens)

Newly-enumerated NPIs with their EXACT Provider Enumeration Date and taxonomy detail, from the CMS NPPES full monthly file joined to the NPPES directory. Answers: which providers/organizations of a given taxonomy were newly issued an NPI in my state since a date? Precise new-provider dating (enumerated_since) that sharpens the existing NPPES event feed. Filter: enumerated_since/before, taxonomy, state, license_state, entity_type, active_only; sort by enumeration_date. [price: $0.03/call]

Input parameters:

- `active_only` (boolean): exclude deactivated NPIs
- `entity_type` (string): 'I' individual | 'O' organization
- `enumerated_before` (string): NPIs enumerated on/before this date (YYYY-MM-DD)
- `enumerated_since` (string): NPIs enumerated on/after this date (YYYY-MM-DD)
- `license_state` (string): primary license state code(s)
- `limit` (integer)
- `offset` (integer)
- `sort` (string): enumeration_date|last_update_date, optionally :asc/:desc
- `state` (string): practice state (from NPPES directory), 2-letter code(s)
- `taxonomy` (string): primary Healthcare Provider Taxonomy code(s), comma-separated, e.g. '207Q00000X'

### `prescribers_partDByDrug_search` (~390 tokens)

Find Medicare Part D prescribers of a specific DRUG or therapeutic CLASS at NPI level — the core pharma targeting query. Filter by drug_class (GLP-1, SGLT2, DPP-4, Statin, from partd_drug_class) or a single drug (brand or generic, e.g. 'Ozempic'), plus specialty, state, min_claims, min_beneficiaries, year. Each hit carries the drug's claim/cost volume and the prescriber's specialty/state/city. Public CMS provider-level data; not a consumer report. [price: $0.03/call]

Input parameters:

- `brand_name` (string): CMS brand-name prefix (case-insensitive), e.g. 'Eliquis'
- `drug` (string): a single drug, brand or generic (e.g. 'Ozempic' or 'Semaglutide'); brands resolve to the canonical generic
- `drug_class` (string): therapeutic class from partd_drug_class, e.g. 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
- `generic_name` (string): CMS generic-name prefix (case-insensitive), e.g. 'Apixaban'
- `limit` (integer)
- `min_beneficiaries` (integer): minimum total beneficiaries (null/suppressed rows excluded)
- `min_claims` (integer): minimum total Part D claims for the drug (that year)
- `offset` (integer)
- `specialty` (string): prescriber specialty substring, e.g. 'Endocrinology'
- `state` (string): 2-letter prescriber state code(s), comma-separated
- `year` (integer): performance year (loaded: 2023, 2024; default 2024)

### `prescribers_partDClassYoyDelta_search` (~381 tokens)

Find prescribers who ENTERED or LEFT a Medicare Part D therapeutic class year-over-year (PY2023→PY2024) — the switchable moment for a pharma team. direction=new_entrant returns NPIs writing the class in 2024 who wrote ≤max_prior_claims in 2023 (new-to-class); direction=de_adopter returns NPIs whose class volume fell ≥min_pct_drop%. Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), state, specialty. Public CMS provider-level data; not a consumer report. [price: $0.1/call]

Input parameters:

- `direction` (string): new_entrant (new-to-class, default) or de_adopter (churned out)
- `drug_class` (string, required): therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
- `limit` (integer)
- `max_prior_claims` (integer): new_entrant: maximum PY2023 class claims to still count as 'new' (default 0)
- `min_claims_2024` (integer): new_entrant: minimum PY2024 class claims (default 20)
- `min_pct_drop` (number): de_adopter: minimum % drop PY2023→PY2024 (default 50)
- `min_prior_claims` (integer): de_adopter: minimum PY2023 class claims (the base they dropped from; default 20)
- `offset` (integer)
- `specialty` (string): prescriber specialty substring, e.g. 'Endocrinology'
- `state` (string): 2-letter prescriber state code(s), comma-separated

### `prescribers_partDClassWhitespace_search` (~318 tokens)

Find high-volume Medicare Part D prescribers of a therapeutic class who have NO reported CMS Open Payments — the greenfield 'reachable before a competitor' audience for a smaller or newer brand. Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), min_claims, state, specialty, and optionally nature_of_payment (whitespace within that payment category). Anti-join of by-drug prescribers to Open Payments recipients. Public CMS data; not a consumer report. [price: $0.1/call]

Input parameters:

- `drug_class` (string, required): therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
- `engaged` (string): true → INVERT: high-volume class prescribers who ARE receiving Open Payments (reachable KOLs), with op_total_amount. Default false = whitespace (unpaid).
- `limit` (integer)
- `min_claims` (integer): minimum PY2024 class claims to count as high-volume (default 50)
- `nature_of_payment` (string): optional: whitespace within a payment category, e.g. 'Consulting'; omit for no payments at all
- `offset` (integer)
- `specialty` (string): prescriber specialty substring, e.g. 'Endocrinology'
- `state` (string): 2-letter prescriber state code(s), comma-separated

### `prescribers_partDAtypicalSpecialty_search` (~266 tokens)

Find Medicare Part D prescribers of a therapeutic class whose specialty is OUTSIDE the class's typical set — off-specialty early adopters (e.g. a GLP-1 written by a cardiologist or nephrologist rather than an endocrinologist/PCP). Filter by drug_class (GLP-1|SGLT2|DPP-4|Statin), min_claims, state; override the typical set with typical_specialties. Public CMS provider-level data; not a consumer report. [price: $0.1/call]

Input parameters:

- `drug_class` (string, required): therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
- `limit` (integer)
- `min_claims` (integer): minimum PY2024 class claims (default 20)
- `offset` (integer)
- `specialty` (string): further restrict the atypical set to a specialty substring
- `state` (string): 2-letter prescriber state code(s), comma-separated
- `typical_specialties` (string): override the built-in typical set (comma-separated substrings); atypical = the complement

### `prescribers_partDBrandShareShift_search` (~320 tokens)

Find prescribers whose within-class molecule mix shifted toward or away from a molecule year-over-year (PY2023→PY2024) — e.g. GLP-1 prescribers moving share toward Tirzepatide. Params: drug_class (GLP-1|SGLT2|DPP-4|Statin), molecule (a generic in the class), direction (toward|away), min_claims (class volume), min_share_shift (percentage points), state, specialty. Share is molecule claims ÷ class claims that year. Public CMS data; not a consumer report. [price: $0.1/call]

Input parameters:

- `direction` (string): share moved toward the molecule (default) or away from it
- `drug_class` (string, required): therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
- `limit` (integer)
- `min_claims` (integer): minimum PY2024 class claims (default 50)
- `min_share_shift` (number): minimum absolute share change in percentage points (default 10)
- `molecule` (string, required): a generic within the class, e.g. 'Tirzepatide' or 'Empagliflozin'
- `offset` (integer)
- `specialty` (string): prescriber specialty substring
- `state` (string): 2-letter prescriber state code(s), comma-separated

### `prescribers_lookup_search` (~243 tokens)

Look up a prescriber by NAME (or exact NPI) and get identity plus a Medicare Part D prescribing summary. Matches the NPPES directory by name prefix (first/last), optionally narrowed by state and specialty, then rolls up that NPI's latest-year Part D claims: top drug, distinct drugs, beneficiaries, and tracked class flags (GLP-1/SGLT2/DPP-4/Statin) with a new-to-class signal. Provide name or npi. Public CMS + NPPES provider-level data; not a consumer report. [price: $0.05/call]

Input parameters:

- `limit` (integer)
- `name` (string): prescriber name, free-text; 'Smith' (last-name prefix) or 'John Smith' (first + last prefixes)
- `npi` (string): exact 10-digit NPI (alternative to name)
- `offset` (integer)
- `specialty` (string): NPPES specialty substring, e.g. 'Endocrinology'
- `state` (string): 2-letter state code(s), comma-separated — narrows the name match

### `prescribers_partD_search` (~237 tokens)

Screen Medicare Part D prescribers by specialty, state, and claim volume — the per-prescriber roster a pharma / device team targets. Optional drug_category (brand | opioid | opioid_long_acting | antibiotic) selects the matching CMS *_total_claims column for BOTH the min_claims threshold and the ranking (else total_claims). Returns one row per NPI with the CMS claim rollups. Public CMS provider-level data; not a consumer report. [price: $0.1/call]

Input parameters:

- `drug_category` (string): select the matching CMS *_total_claims column (drives min_claims + sort); omit for total_claims
- `limit` (integer)
- `min_claims` (integer): minimum claims on the selected column (default 50)
- `offset` (integer)
- `performance_year` (integer): Part D program year (default 2024, the latest loaded)
- `specialty` (string): prescriber specialty substring, e.g. 'Endocrinology'
- `state` (string): 2-letter prescriber state code(s), comma-separated

### `openPayments_recipients_search` (~214 tokens)

Screen physicians industry is already paying — the recipient side of the CMS Open Payments (Sunshine Act) file, ranked by total reported payment amount. Filter by specialty, state, nature_of_payment, and min_amount. Prescriber name / specialty / state / city are resolved by joining the NPI to the CMS Part D Prescribers file (Open Payments carries none of them). Public CMS provider-level data; not a consumer report. [price: $0.1/call]

Input parameters:

- `limit` (integer)
- `min_amount` (number): minimum reported total payment amount (USD)
- `nature_of_payment` (string): payment category substring, e.g. 'Consulting'
- `offset` (integer)
- `performance_year` (integer): Open Payments program year (default 2024, the latest loaded)
- `specialty` (string): prescriber specialty substring, e.g. 'Cardiology'
- `state` (string): 2-letter prescriber state code(s), comma-separated

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-healthparse-gateway/api#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 66
- 2026-08-01: 66
- 2026-07-31: 63
- 2026-07-30: 61
- 2026-07-28: 60
- 2026-07-27: 59
- 2026-07-26: 59

## Links

- Remote endpoint: https://api.healthparse.io/mcp
- Website: https://healthparse.io/developers
- Changelog RSS feed: https://verifymcp.io/servers/io-healthparse-gateway/api/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-healthparse-gateway/api/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-healthparse-gateway/api