@uh-joan/healthcare-data-mcp-server
Advanced tools
Healthcare Data MCP server providing access to NLM and CMS data sources.
This server provides access to healthcare data through seven main tools:
nlm_search_icd10: Search for ICD-10-CM codes using the National Library of Medicine (NLM) APInlm_search_npi_org: Search for healthcare providers using the National Library of Medicine's (NLM) National Provider Identifier (NPI) database (organizations)nlm_search_npi_ind: Search for individual healthcare providers using the National Library of Medicine's (NLM) National Provider Identifier (NPI) database (individuals)cms_search_providers: Search Medicare Physician & Other Practitioners data for 2023 using the Centers for Medicare & Medicaid Services (CMS) databasenlm_search_hcpcs: Search for HCPCS codes using the National Library of Medicine (NLM) APInlm_search_icd9_diagnoses: Search for ICD-9-CM diagnoses using the National Library of Medicine (NLM) APInlm_search_icd9_procedures: Search for ICD-9-CM procedures using the National Library of Medicine (NLM) APIhealthcare_data_mcp_serverThe nlm_search_icd10 tool provides access to the National Library of Medicine's (NLM) ICD-10-CM code database.
terms (string, required): The search string for which to find matches in the listmaxList (number, default: 500): Specifies the number of results requested, up to the upper limit of 500count (number, default: 500): The number of results to retrieve (page size)offset (number, default: 0): The starting result number (0-based) to retrieveq (string): An optional, additional query string used to further constrain the resultsdf (string, default: "code,name"): A comma-separated list of display fieldssf (string, default: "code,name"): A comma-separated list of fields to be searchedcf (string, default: "code"): A field to regard as the 'code' for the returned item dataef (string): A comma-separated list of additional fields to be returned for each retrieved list itemcurl -X POST http://localhost:3005/nlm_search_icd10 \
-H "Content-Type: application/json" \
-d '{
"terms": "tuberc"
}'
curl -X POST http://localhost:3005/nlm_search_icd10 \
-H "Content-Type: application/json" \
-d '{
"terms": "tuberc",
"q": "code:A15*"
}'
The nlm_search_icd9_diagnoses tool provides access to the National Library of Medicine's (NLM) ICD-9-CM diagnosis code database. ICD-9-CM (International Classification of Diseases, Ninth Revision, Clinical Modification) is a medical coding system for classifying diagnoses and reasons for visits in U.S. health care settings.
terms (string, required): The search string (e.g., part of a code or name) for which to find matches in the list. Multiple words are ANDed together.maxList (number, default: 7, max: 500): Maximum number of results to return.count (number, default: 7, max: 500): Number of results per page. Use for pagination.offset (number, default: 0): Starting result number. Use for pagination. (offset + count <= 7,500)q (string): Additional query constraints. See Elasticsearch query string syntax.df (string, default: code_dotted,long_name): Comma-separated list of fields to display in results.sf (string, default: code,code_dotted,short_name,long_name): Comma-separated list of fields to search in.cf (string, default: code): Field to regard as the 'code' for the returned item data.ef (string): Comma-separated list of extra fields to include. Can use aliases with colon syntax: field_name:alias.code: The ICD-9-CM diagnosis code, e.g., 0011, V092code_dotted: The decimal version of the ICD-9-CM diagnosis code, e.g., 001.1, V09.2short_name: The abbreviated name of the diagnosislong_name: The full name of the diagnosiscurl -X POST http://localhost:3005/nlm_search_icd9_diagnoses \
-H "Content-Type: application/json" \
-d '{
"terms": "diabetes",
"count": 3
}'
Output:
{
"total": 72,
"codes": [
{ "code": "253.5", "code_dotted": "253.5", "short_name": "", "long_name": " Diabetes insipidus" },
{ "code": "648.01", "code_dotted": "648.01", "short_name": "", "long_name": " Diabetes mellitus of mother, complicating pregnancy, childbirth, or the puerperium, delivered, with or without mention of antepartum condition" },
{ "code": "648.03", "code_dotted": "648.03", "short_name": "", "long_name": " Diabetes mellitus of mother, complicating pregnancy, childbirth, or the puerperium, antepartum condition or complication" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_diagnoses \
-H "Content-Type: application/json" \
-d '{
"terms": "08",
"count": 2
}'
Output:
{
"total": 51,
"codes": [
{ "code": "080", "code_dotted": "080", "short_name": "", "long_name": " Louse-borne (epidemic) typhus" },
{ "code": "081.0", "code_dotted": "081.0", "short_name": "", "long_name": " Murine (endemic) typhus" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_diagnoses \
-H "Content-Type: application/json" \
-d '{
"terms": "brai",
"ef": "short_name",
"count": 2
}'
Output:
{
"total": 120,
"codes": [
{ "code": "006.5", "code_dotted": "006.5", "short_name": " Amebic brain abscess", "long_name": " Amebic brain abscess" },
{ "code": "013.20", "code_dotted": "013.20", "short_name": " Tuberculoma brain-unspec", "long_name": " Tuberculoma of brain, unspecified" }
]
}
The nlm_search_icd9_procedures tool provides access to the National Library of Medicine's (NLM) ICD-9-CM procedure code database. ICD-9-CM (International Classification of Diseases, Ninth Revision, Clinical Modification) is a medical coding system for classifying procedures and reasons for visits in U.S. health care settings.
terms (string, required): The search string (e.g., part of a code or name) for which to find matches in the list. Multiple words are ANDed together.maxList (number, default: 7, max: 500): Maximum number of results to return.count (number, default: 7, max: 500): Number of results per page. Use for pagination.offset (number, default: 0): Starting result number. Use for pagination. (offset + count <= 7,500)q (string): Additional query constraints. See Elasticsearch query string syntax.df (string, default: code_dotted,long_name): Comma-separated list of fields to display in results.sf (string, default: code,code_dotted,short_name,long_name): Comma-separated list of fields to search in.cf (string, default: code): Field to regard as the 'code' for the returned item data.ef (string): Comma-separated list of extra fields to include. Can use aliases with colon syntax: field_name:alias.code: The ICD-9-CM procedure code, e.g., 210, 0780code_dotted: The decimal version of the ICD-9-CM procedure code, e.g., 21.0, 07.80short_name: The abbreviated name of the procedurelong_name: The full name of the procedurecurl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "08",
"count": 3
}'
Output:
{
"total": 49,
"codes": [
{ "code": "08.01", "code_dotted": "08.01", "short_name": "", "long_name": "Incision of lid margin" },
{ "code": "08.02", "code_dotted": "08.02", "short_name": "", "long_name": "Severing of blepharorrhaphy" },
{ "code": "08.09", "code_dotted": "08.09", "short_name": "", "long_name": "Other incision of eyelid" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "brai",
"ef": "short_name",
"count": 3
}'
Output:
{
"total": 20,
"codes": [
{ "code": "00.19", "code_dotted": "00.19", "short_name": "BBBD via infusion", "long_name": "Disruption of blood brain barrier via infusion [BBBD]" },
{ "code": "01.13", "code_dotted": "01.13", "short_name": "Closed brain biopsy", "long_name": "Closed [percutaneous] [needle] biopsy of brain" },
{ "code": "01.14", "code_dotted": "01.14", "short_name": "Open brain biopsy", "long_name": "Open biopsy of brain" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "heart",
"count": 5,
"ef": "short_name"
}'
Output:
{
"total": 61,
"codes": [
{ "code": "37.51", "code_dotted": "37.51", "short_name": "Heart transplantation", "long_name": "Heart transplantation" },
{ "code": "35.95", "code_dotted": "35.95", "short_name": "Heart repair revision", "long_name": "Revision of corrective procedure on heart" },
{ "code": "36.39", "code_dotted": "36.39", "short_name": "Oth heart revascular", "long_name": "Other heart revascularization" },
{ "code": "37.32", "code_dotted": "37.32", "short_name": "Heart aneurysm excision", "long_name": "Excision of aneurysm of heart" },
{ "code": "37.92", "code_dotted": "37.92", "short_name": "Injection into heart", "long_name": "Injection of therapeutic substance into heart" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "fracture",
"q": "code:79*",
"count": 4
}'
Output:
{
"total": 50,
"codes": [
{ "code": "79.60", "code_dotted": "79.60", "short_name": "", "long_name": "Open fx site debride NOS" },
{ "code": "79.61", "code_dotted": "79.61", "short_name": "", "long_name": "Debrid open fx-humerus" },
{ "code": "79.65", "code_dotted": "79.65", "short_name": "", "long_name": "Debrid opn fx-femur" },
{ "code": "79.01", "code_dotted": "79.01", "short_name": "", "long_name": "Closed fx reduct humerus" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "replacement",
"count": 5,
"offset": 0,
"ef": "short_name"
}'
Output:
{
"total": 149,
"codes": [
{ "code": "81.51", "code_dotted": "81.51", "short_name": "Total hip replacement", "long_name": "Total hip replacement" },
{ "code": "81.52", "code_dotted": "81.52", "short_name": "Partial hip replacement", "long_name": "Partial hip replacement" },
{ "code": "81.54", "code_dotted": "81.54", "short_name": "Total knee replacement", "long_name": "Total knee replacement" },
{ "code": "81.56", "code_dotted": "81.56", "short_name": "Total ankle replacement", "long_name": "Total ankle replacement" },
{ "code": "81.73", "code_dotted": "81.73", "short_name": "Total wrist replacement", "long_name": "Total wrist replacement" }
]
}
curl -X POST http://localhost:3005/nlm_search_icd9_procedures \
-H "Content-Type: application/json" \
-d '{
"terms": "endoscopic",
"q": "code:45* OR code:44*",
"count": 3,
"ef": "short_name"
}'
Output:
{
"total": 9,
"codes": [
{ "code": "44.32", "code_dotted": "44.32", "short_name": "Percu gastrojejunostomy", "long_name": "Percu gastrojejunostomy" },
{ "code": "44.22", "code_dotted": "44.22", "short_name": "Endoscop dilate pylorus", "long_name": "Endoscop dilate pylorus" },
{ "code": "44.14", "code_dotted": "44.14", "short_name": "Closed gastric biopsy", "long_name": "Closed gastric biopsy" }
]
}
The nlm_search_npi_org tool provides access to the National Library of Medicine's (NLM) National Provider Identifier (NPI) database, allowing searches for healthcare providers by name, location, provider type, and other criteria.
terms (string, required): Search terms (name, NPI, or other identifiers). Multiple words are ANDed togethermaxList (number, default: 500): Maximum number of results to returncount (number, default: 500): Number of results per page. Use for paginationoffset (number, default: 0): Starting result number. Use for paginationq (string): Additional query constraints. Examples:
addr_practice.city:Bethesdaprovider_type:Physicianprovider_type:Organizationaddr_practice.state:NY AND provider_type:Individualdf (string): Comma-separated list of fields to display in resultssf (string): Comma-separated list of fields to search inef (string): Comma-separated list of extra fields to includecurl -X POST http://localhost:3005/nlm_search_npi_org \
-H "Content-Type: application/json" \
-d '{
"terms": "john",
"q": "addr_practice.city:Bethesda AND provider_type:Physician",
"sf": "NPI,name.full,provider_type,addr_practice.city",
"df": "NPI,name.full,provider_type,addr_practice"
}'
curl -X POST http://localhost:3005/nlm_search_npi_org \
-H "Content-Type: application/json" \
-d '{
"terms": "hospital",
"q": "provider_type:Organization",
"ef": "taxonomy,addr_practice",
"df": "NPI,name.full,provider_type,addr_practice,taxonomy",
"count": 2
}'
The nlm_search_npi_ind tool provides access to the National Library of Medicine's (NLM) National Provider Identifier (NPI) database for individual providers. This tool supports advanced queries using hierarchical fields, dot notation, and array indices for both searching and display.
terms (string, required): Search terms (name, NPI, or other identifiers). Multiple words are ANDed together.maxList (number, default: 7, max: 500): Maximum number of results to return.count (number, default: 7, max: 500): Number of results per page. Use for pagination.offset (number, default: 0): Starting result number. Use for pagination. (offset + count <= 7,500)q (string): Additional query constraints. Examples:
addr_practice.city:Bethesdaprovider_type:Physiciangender:Faddr_practice.state:NY AND provider_type:Physiciandf (string): Comma-separated list of fields to display in results. Supports dot notation and array indices (e.g., licenses[0].taxonomy.code).sf (string): Comma-separated list of fields to search in. Supports dot notation and array indices.cf (string): Field to regard as the 'code' for the returned item data (default: NPI).ef (string): Comma-separated list of extra fields to include. Can use aliases with colon syntax: field_name:alias.curl -X POST http://localhost:3005/nlm_search_npi_ind \
-H "Content-Type: application/json" \
-d '{
"terms": "smith",
"count": 2
}'
Output:
{
"total": 10000,
"providers": [
{ "NPI": "1871139162", "name": "DONTHI, ANKITH", "provider_type": "Nurse Practitioner", "address": "111 OTIS SMITH DR OTIS SMITH, CLARKSVILLE, TN 37043" },
{ "NPI": "1508500414", "name": "ABIOYE, ABIODUN", "provider_type": "Physician/Internal Medicine", "address": "7301 ROGERS AVE MERCY FORT SMITH, FORT SMITH, AR 72903" }
]
}
curl -X POST http://localhost:3005/nlm_search_npi_ind \
-H "Content-Type: application/json" \
-d '{
"terms": "smith",
"q": "gender:F AND provider_type:Physician",
"count": 2
}'
Output:
{
"total": 4086,
"providers": [
{ "NPI": "1861724221", "name": "CRANE, NICOLE", "provider_type": "Physician Assistant", "address": "303 SMITH ST, LAGRANGE, GA 30240" },
{ "NPI": "1316918568", "name": "VERNAY, KATHRYN", "provider_type": "Physician Assistant", "address": "1351 SMITH ST, FABIUS, NY 13063" }
]
}
curl -X POST http://localhost:3005/nlm_search_npi_ind \
-H "Content-Type: application/json" \
-d '{
"terms": "boston",
"q": "addr_practice.city:Boston AND other_ids.id:*",
"df": "name.full,addr_practice.full,other_ids[0].id",
"sf": "addr_practice.city,other_ids.id",
"count": 2
}'
Output:
{
"total": 5638,
"providers": [
{ "NPI": "1497028419", "name": "185 PILGRIM RD, BOSTON, MA 02215", "provider_type": "F336459-1", "address": "" },
{ "NPI": "1811991201", "name": "300 LONGWOOD AVE FEGAN 3, BOSTON, MA 02115", "provider_type": "286370099", "address": "" }
]
}
The cms_search_providers tool provides access to Medicare Physician & Other Practitioners data using the Centers for Medicare & Medicaid Services (CMS) database. This data includes information about services and procedures provided to Original Medicare Part B beneficiaries. The tool supports data from 2013 to the latest available year, defaulting to the latest year if not specified.
dataset_type (required): Type of dataset to search
geography_and_service: Use when you need to:
provider_and_service: Use when you need to:
provider: Use when you need to:
year (optional): Year of the dataset to query (2023 to latest available year, defaults to latest year). Note that data availability may vary by year and dataset type.hcpcs_code (optional): HCPCS code to search for (e.g., '99213' for established patient office visit). Can be used to analyze specific procedures or services.provider_type (optional): Type of provider to search for (e.g., 'Cardiology', 'Podiatry', 'Family Practice'). Supports partial matches and is case-insensitive.geo_level (optional): Geographic level for filtering (e.g., "National", "State", "County", "ZIP"). Use with geo_code to filter results by specific geographic areas.geo_code (optional): Geographic code to filter by (e.g., 'CA' for California, '06037' for Los Angeles County). Must match the geo_level specified.place_of_service (optional): Place of service code to filter by (e.g., 'F' for facility, 'O' for office, 'H' for hospital). See CMS documentation for complete list of codes.size (optional): Number of results to return (default: 10, max: 5000). Use with offset for pagination of large result sets.offset (optional): Starting result number for pagination (default: 0). Use with size to navigate through large result sets.sort_by (optional): Field to sort results by. Common fields include 'Tot_Srvcs' (total services), 'Tot_Benes' (total beneficiaries), 'Tot_Mdcr_Pymt_Amt' (total Medicare payment).sort_order (optional): Sort order ("asc" or "desc", default: "desc").The response fields vary by dataset type:
geography_and_service dataset:Rndrng_Prvdr_Geo_Lvl: Geographic level (National, State, County, ZIP)Rndrng_Prvdr_Geo_Cd: Geographic code (e.g., 'CA' for California)Rndrng_Prvdr_Geo_Desc: Geographic descriptionHCPCS_Cd: HCPCS codeHCPCS_Desc: Description of the service/procedureHCPCS_Drug_Ind: Indicates if the service is drug-relatedPlace_Of_Srvc: Place of service codeTot_Rndrng_Prvdrs: Total number of rendering providersTot_Benes: Total number of beneficiariesTot_Srvcs: Total number of servicesTot_Bene_Day_Srvcs: Total beneficiary days of serviceAvg_Sbmtd_Chrg: Average submitted chargeAvg_Mdcr_Alowd_Amt: Average Medicare allowed amountAvg_Mdcr_Pymt_Amt: Average Medicare payment amountAvg_Mdcr_Stdzd_Amt: Average standardized Medicare payment amountprovider_and_service dataset:Rndrng_NPI: Provider's National Provider IdentifierRndrng_Prvdr_Last_Org_Name: Provider's last name or organization nameRndrng_Prvdr_First_Name: Provider's first nameRndrng_Prvdr_MI: Provider's middle initialRndrng_Prvdr_Crdntls: Provider's credentialsRndrng_Prvdr_Ent_Cd: Provider's entity typeRndrng_Prvdr_St1: Provider's street addressRndrng_Prvdr_City: Provider's cityRndrng_Prvdr_State_Abrvtn: Provider's stateRndrng_Prvdr_Zip5: Provider's ZIP codeRndrng_Prvdr_Type: Provider's specialty/typeRndrng_Prvdr_Mdcr_Prtcptg_Ind: Medicare participating indicatorHCPCS_Cd: HCPCS codeHCPCS_Desc: Description of the service/procedurePlace_Of_Srvc: Place of service codeTot_Benes: Total number of beneficiariesTot_Srvcs: Total number of servicesTot_Bene_Day_Srvcs: Total beneficiary days of serviceAvg_Sbmtd_Chrg: Average submitted chargeAvg_Mdcr_Alowd_Amt: Average Medicare allowed amountAvg_Mdcr_Pymt_Amt: Average Medicare payment amountAvg_Mdcr_Stdzd_Amt: Average standardized Medicare payment amountprovider dataset:Rndrng_NPI: Provider's National Provider IdentifierRndrng_Prvdr_Last_Org_Name: Provider's last name or organization nameRndrng_Prvdr_First_Name: Provider's first nameRndrng_Prvdr_MI: Provider's middle initialRndrng_Prvdr_Crdntls: Provider's credentialsRndrng_Prvdr_Ent_Cd: Provider's entity typeRndrng_Prvdr_St1: Provider's street addressRndrng_Prvdr_City: Provider's cityRndrng_Prvdr_State_Abrvtn: Provider's stateRndrng_Prvdr_Zip5: Provider's ZIP codeRndrng_Prvdr_Type: Provider's specialty/typeRndrng_Prvdr_Mdcr_Prtcptg_Ind: Medicare participating indicatorTot_HCPCS_Cds: Total number of unique HCPCS codesTot_Benes: Total number of beneficiariesTot_Srvcs: Total number of servicesTot_Sbmtd_Chrg: Total submitted chargesTot_Mdcr_Alowd_Amt: Total Medicare allowed amountTot_Mdcr_Pymt_Amt: Total Medicare payment amountTot_Mdcr_Stdzd_Amt: Total standardized Medicare payment amountBene_Avg_Age: Average beneficiary ageBene_Age_LT_65_Cnt: Number of beneficiaries under 65Bene_Age_65_74_Cnt: Number of beneficiaries aged 65-74Bene_Age_75_84_Cnt: Number of beneficiaries aged 75-84Bene_Age_GT_84_Cnt: Number of beneficiaries over 84Bene_Feml_Cnt: Number of female beneficiariesBene_Male_Cnt: Number of male beneficiariesBene_Race_Wht_Cnt: Number of white beneficiariesBene_Race_Black_Cnt: Number of black beneficiariesBene_Race_API_Cnt: Number of Asian/Pacific Islander beneficiariesBene_Race_Hspnc_Cnt: Number of Hispanic beneficiariesBene_Race_NatInd_Cnt: Number of Native American beneficiariesBene_Race_Othr_Cnt: Number of beneficiaries of other racesBene_Dual_Cnt: Number of dual-eligible beneficiariesBene_Ndual_Cnt: Number of non-dual-eligible beneficiariesBene_Avg_Risk_Scre: Average beneficiary risk score{
"dataset_type": "geography_and_service",
"geo_level": "State",
"geo_code": "CA",
"hcpcs_code": "99213",
"year": 2023
}
{
"dataset_type": "geography_and_service",
"geo_level": "State",
"hcpcs_code": "27447",
"year": 2023,
"sort": "Tot_Srvcs",
"order": "desc",
"limit": 10
}
{
"dataset_type": "geography_and_service",
"geo_level": "County",
"geo_code": "06037",
"hcpcs_code": "27130",
"year": 2023
}
{
"dataset_type": "geography_and_service",
"geo_level": "ZIP",
"hcpcs_code": "99214",
"year": 2023,
"sort": "Avg_Mdcr_Pymt_Amt",
"order": "desc",
"limit": 5
}
{
"dataset_type": "provider_and_service",
"geo_level": "State",
"geo_code": "CA",
"hcpcs_code": "27447",
"year": 2023,
"sort": "Tot_Srvcs",
"order": "desc",
"limit": 10
}
{
"dataset_type": "provider_and_service",
"provider_type": "Cardiology",
"hcpcs_code": "93010",
"year": 2023,
"sort": "Tot_Srvcs",
"order": "desc"
}
{
"dataset_type": "provider_and_service",
"geo_level": "ZIP",
"geo_code": "90210",
"hcpcs_code": "99213",
"year": 2023
}
{
"dataset_type": "provider_and_service",
"hcpcs_code": "27130",
"year": 2023,
"sort": "Avg_Mdcr_Pymt_Amt",
"order": "desc",
"limit": 5
}
{
"dataset_type": "provider",
"geo_level": "State",
"geo_code": "CA",
"year": 2023,
"sort": "Tot_Srvcs",
"order": "desc",
"limit": 10
}
{
"dataset_type": "provider",
"provider_type": "Orthopedic Surgery",
"year": 2023,
"sort": "Tot_Benes",
"order": "desc"
}
{
"dataset_type": "provider",
"geo_level": "County",
"geo_code": "06037",
"year": 2023,
"sort": "Bene_Avg_Risk_Scre",
"order": "desc"
}
{
"dataset_type": "provider",
"year": 2023,
"sort": "Tot_Mdcr_Pymt_Amt",
"order": "desc",
"limit": 5
}
Geographic Analysis
cms_search_providers (geography_and_service dataset)Provider Analysis
cms_search_providers (provider dataset), nlm_search_npi_orgService Analysis
cms_search_providers (provider_and_service dataset), nlm_search_hcpcsBeneficiary Analysis
cms_search_providers (provider dataset)Payment Analysis
cms_search_providers (geography_and_service dataset, provider_and_service dataset)Provider and Service Analysis
nlm_search_npi_org: Retrieve provider details and specialties.cms_search_providers (provider_and_service dataset): Analyze the provider's service volumes and Medicare payments.cms_search_providers (geography_and_service dataset): Compare the provider's performance with regional averages.Comprehensive Healthcare Utilization Analysis
nlm_search_icd10: Retrieve relevant ICD-10 codes for specific diagnoses.nlm_search_hcpcs: Retrieve relevant HCPCS codes for specific procedures.cms_search_providers (geography_and_service dataset): Analyze regional utilization patterns.cms_search_providers (provider_and_service dataset): Analyze provider-level utilization patterns.Beneficiary and Provider Analysis
cms_search_providers (provider dataset): Retrieve beneficiary demographics and risk scores for specific providers.cms_search_providers (geography_and_service dataset): Compare with regional averages.Payment and Service Analysis
nlm_search_hcpcs: Retrieve relevant HCPCS codes for specific services.cms_search_providers (geography_and_service dataset): Analyze regional payment patterns.cms_search_providers (provider_and_service dataset): Analyze provider-level payment patterns.The nlm_search_hcpcs tool provides access to the National Library of Medicine's (NLM) HCPCS code database.
terms (string, required): The search string for which to find matches in the listmaxList (number, default: 500): Specifies the number of results requested, up to the upper limit of 500count (number, default: 500): The number of results to retrieve (page size)offset (number, default: 0): The starting result number (0-based) to retrieveq (string): An optional, additional query string used to further constrain the resultsdf (string, default: "code,name"): A comma-separated list of display fieldssf (string, default: "code,name"): A comma-separated list of fields to be searchedcf (string, default: "code"): A field to regard as the 'code' for the returned item dataef (string): A comma-separated list of additional fields to be returned for each retrieved list itemcurl -X POST http://localhost:3005/nlm_search_hcpcs \
-H "Content-Type: application/json" \
-d '{
"terms": "wheelchair",
"maxList": 3
}'
curl -X POST http://localhost:3005/nlm_search_hcpcs \
-H "Content-Type: application/json" \
-d '{
"terms": "wheelchair",
"maxList": 2,
"count": 2,
"offset": 2
}'
curl -X POST http://localhost:3005/nlm_search_hcpcs \
-H "Content-Type: application/json" \
-d '{
"terms": "air",
"maxList": 2,
"count": 2,
"offset": 0,
"q": "code:A*"
}'
curl -X POST http://localhost:3005/nlm_search_hcpcs \
-H "Content-Type: application/json" \
-d '{
"terms": "bed",
"maxList": 2,
"count": 2,
"offset": 0,
"q": "code:E*",
"df": "code,short_desc,long_desc",
"sf": "code,short_desc,long_desc",
"cf": "code",
"ef": "long_desc"
}'
POST /nlm_search_icd10POST /nlm_search_npi_orgPOST /cms_search_providersPOST /nlm_search_hcpcsTo run the server in HTTP mode:
USE_HTTP=true PORT=3005 npm start
The server will be available at http://localhost:3005 with the following endpoints:
POST /nlm_search_icd10POST /nlm_search_npi_orgPOST /cms_search_providersPOST /nlm_search_hcpcsGET /health (health check endpoint)To run the server in MCP mode:
npm start
The server will communicate via stdin/stdout using the Model Context Protocol.
This server is provided as-is, without any warranty. The data is sourced from the National Library of Medicine and Centers for Medicare & Medicaid Services. Please refer to their respective terms of service for usage restrictions and requirements.
FAQs
Healthcare Data MCP server providing access to NLM and CMS data sources.
We found that @uh-joan/healthcare-data-mcp-server demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
/Security News
Socket identified 80 fake candidates targeting engineering roles, including suspected North Korean operators, exposing the new reality of hiring as a security function.
Application Security
/Research
/Security News
Socket detected multiple compromised CrowdStrike npm packages, continuing the "Shai-Hulud" supply chain attack that has now impacted nearly 500 packages.
Research
/Security News
Malicious update to @ctrl/tinycolor on npm is part of a supply-chain attack hitting 40+ packages across maintainers