Healthparse Healthcare Data Gateway

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Healthparse Healthcare Data Gateway": {
      "url": "https://api.healthparse.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (42)

• hcris_hospital_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • zip_prefix — string
  • fy_end_year — integer
  • name_search — string
  • control_type — string
  • hospital_type — string
  • total_beds_max — number
  • total_beds_min — number
  • total_revenues_max — number
  • total_revenues_min — number
  • operating_margin_max — number
  • operating_margin_min — number
  • total_discharges_max — number
  • total_discharges_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hcris_hospital_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hcris_asc_search

  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]

  Parameters:

  • ccn — string
  • limit — integer
  • state — string
  • offset — integer
  • name_search — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hcris_provider_search

  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]

  Parameters:

  • npi — string
  • limit — integer
  • state — string
  • offset — integer
  • specialty — string
  • total_payment_max — number
  • total_payment_min — number
  • total_services_max — number
  • total_services_min — number
  • total_beneficiaries_max — number
  • total_beneficiaries_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• irs990_org_search

  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]

  Parameters:

  • limit — integer
  • state — string
  • offset — integer
  • ntee_code — string
  • name_search — string
  • revenue_max — number
  • revenue_min — number
  • net_income_max — number
  • net_income_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• irs990_org_byEin

  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]

  Parameters:

  • ein (required) — string — Path parameter: IRS Employer Identification Number (EIN)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• irs990_officers_search

  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]

  Parameters:

  • ein — string
  • limit — integer
  • offset — integer
  • name_search — string
  • total_compensation_max — number
  • total_compensation_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sanctions_leie_search

  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]

  Parameters:

  • npi — string
  • limit — integer
  • state — string
  • offset — integer
  • exclusion_type — string
  • last_name_search — string
  • business_name_search — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• oews_wage_search

  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]

  Parameters:

  • year — integer
  • limit — integer
  • state — string
  • offset — integer
  • area_code — string
  • area_type — string
  • occupation_code — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_hospitals_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • zip_prefix — string
  • overall_rating_max — number
  • overall_rating_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_hospitals_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_snf_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • zip_prefix — string
  • overall_rating_max — number
  • overall_rating_min — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_snf_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_home-health_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • rating_max — number
  • rating_min — number
  • zip_prefix — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_home-health_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_hospice_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • rating_max — number
  • rating_min — number
  • zip_prefix — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_hospice_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_dialysis_search

  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]

  Parameters:

  • city — string
  • limit — integer
  • state — string
  • offset — integer
  • rating_max — number
  • rating_min — number
  • zip_prefix — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• carecompare_dialysis_byCcn

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hpt_rates_search

  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]

  Parameters:

  • ccn — string
  • limit — integer
  • payer — string
  • state — string
  • offset — integer
  • rate_type — string
  • billing_code — string
  • billing_code_type — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• sanctions_screen

  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]

  Parameters:

  • npi — string
  • name — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hpt_code_stats

  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]

  Parameters:

  • code (required) — string — Path parameter: billing code (CPT/HCPCS/MS-DRG)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hcris_hospital_financials

  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]

  Parameters:

  • ccn (required) — string — Path parameter: CMS Certification Number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• providers_events_feed

  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]

  Parameters:

  • ccn — string
  • npi — string
  • 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_decert, capex_jump
  • limit — integer
  • since — string — only events on/after this date (YYYY-MM-DD)
  • state — string — 2-letter state code(s), comma-separated
  • cursor — string — opaque next_cursor from the previous page

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hospitals_capex_signals

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• providers_provider360

  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]

  Parameters:

  • npi (required) — string — Path parameter: 10-digit National Provider Identifier (NPI)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• manufacturers_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• manufacturers_openPayments

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hrsa_healthCenters_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hrsa_hpsa_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• hrsa_coveredEntities340b_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• nppes_enumeration_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partDByDrug_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partDClassYoyDelta_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partDClassWhitespace_search

  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]

  Parameters:

  • drug_class (required) — string — therapeutic class from partd_drug_class: 'GLP-1' | 'SGLT2' | 'DPP-4' | 'Statin'
  • limit — integer
  • state — string — 2-letter prescriber state code(s), comma-separated
  • offset — integer
  • engaged — string — true → INVERT: high-volume class prescribers who ARE receiving Open Payments (reachable KOLs), with op_total_amount. Default false = whitespace (unpaid).
  • specialty — string — prescriber specialty substring, e.g. 'Endocrinology'
  • 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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partDAtypicalSpecialty_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partDBrandShareShift_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_lookup_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• prescribers_partD_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• openPayments_recipients_search

  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]

  Parameters:

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• openPayments_recipients_yoyIncrease_search

  Physicians whose TOTAL CMS Open Payments industry payments genuinely increased year-over-year — a real per-NPI delta (amount_current vs amount_prior), not a magnitude threshold. Defaults to 2023→2024 (any loaded year pair selectable via year/prior_year). Filter: specialty, state, min_increase_usd (default $1,000), min_pct_change (default 10%). Only physicians paid in BOTH years with a real rise clearing both thresholds are returned. Public CMS provider-level data; not a consumer report. [price: $0.1/call]

  Parameters:

  • year — integer — current program year (default 2024, the latest loaded)
  • limit — integer
  • state — string — 2-letter prescriber state code(s), comma-separated
  • offset — integer
  • specialty — string — prescriber specialty substring, e.g. 'Cardiology'
  • prior_year — integer — comparison program year (default year-1)
  • min_pct_change — number — minimum percent increase (default 10)
  • min_increase_usd — number — minimum dollar increase (default 1000)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• manufacturers_openPayments_yoyIncrease_search

  Manufacturers/GPOs whose TOTAL Open Payments spend genuinely increased year-over-year — a real per-manufacturer delta (amount_current vs amount_prior), not a magnitude threshold. Defaults to 2023→2024 (any loaded year pair via year/prior_year). Filter: specialty, state, min_increase_usd (default $10,000), min_pct_change (default 10%). NOTE: op_manufacturer_payments holds only PY2024 today — real, returns total_matched=0 (never fabricated) until a prior year is imported; see stage1b-report.md. [price: $0.1/call]

  Parameters:

  • year — integer — current program year (default 2024, the latest loaded)
  • limit — integer
  • state — string — 2-letter recipient state code(s), comma-separated
  • offset — integer
  • specialty — string — recipient specialty substring, e.g. 'Cardiology'
  • prior_year — integer — comparison program year (default year-1)
  • min_pct_change — number — minimum percent increase (default 10)
  • min_increase_usd — number — minimum dollar increase (default 10000)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.