Clinical Tables Tools#

Configuration File: clinical_tables_tools.json Tool Type: Local Tools Count: 6

This page contains all tools defined in the clinical_tables_tools.json configuration file.

Available Tools#

DiseaseNames_search (Type: ClinicalTablesTool)#

Disease-name autocomplete via the NLM Clinical Table Search Service (disease_names table). Given …

DiseaseNames_search tool specification

Tool Information:

  • Name: DiseaseNames_search

  • Type: ClinicalTablesTool

  • Description: Disease-name autocomplete via the NLM Clinical Table Search Service (disease_names table). Given a partial or full disease name, returns matching disease names with their UMLS Concept Unique Identifier (CUI) in the code field. Sourced from UMLS/MedlinePlus disease vocabulary. Use to normalize a free-text disease mention to a canonical disease name and UMLS CUI for cross-vocabulary linking. No API key required.

Parameters:

  • terms (string) (required) Disease name or prefix to search, e.g. ‘cystic fibrosis’, ‘lupus’, ‘sickle cell’.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "DiseaseNames_search",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)

HCPCS_search (Type: ClinicalTablesTool)#

US procedure and durable-medical-equipment billing code autocomplete via the NLM Clinical Table S…

HCPCS_search tool specification

Tool Information:

  • Name: HCPCS_search

  • Type: ClinicalTablesTool

  • Description: US procedure and durable-medical-equipment billing code autocomplete via the NLM Clinical Table Search Service (HCPCS Level II). Given a partial or full description, returns matching HCPCS codes with their official short description. Use for billing/coding lookups (e.g. wheelchairs, ambulance services, supplies) not covered by CPT. No API key required.

Parameters:

  • terms (string) (required) Procedure/equipment description or prefix to search, e.g. ‘wheelchair’, ‘ambulance’.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "HCPCS_search",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)

HealthConditions_search (Type: ClinicalTablesTool)#

Health-condition / problem-list autocomplete via the NLM Clinical Table Search Service (condition…

HealthConditions_search tool specification

Tool Information:

  • Name: HealthConditions_search

  • Type: ClinicalTablesTool

  • Description: Health-condition / problem-list autocomplete via the NLM Clinical Table Search Service (conditions table). Given a partial or full condition name, returns matching clinical conditions with their formal primary name, a consumer-friendly name, and a crosswalk to ICD-10-CM and ICD-9-CM codes. Use to map free-text symptoms or problems to standardized conditions and billing codes, or to build a patient problem list. No API key required.

Parameters:

  • terms (string) (required) Condition name or prefix to search, e.g. ‘diabetes’, ‘high blood pressure’, ‘asthma’.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "HealthConditions_search",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)

NPIProvider_search (Type: ClinicalTablesTool)#

US healthcare provider/organization directory search via the NLM Clinical Table Search Service (N…

NPIProvider_search tool specification

Tool Information:

  • Name: NPIProvider_search

  • Type: ClinicalTablesTool

  • Description: US healthcare provider/organization directory search via the NLM Clinical Table Search Service (NPPES NPI Registry). Given a provider or organization name, returns matches with their National Provider Identifier (NPI), specialty/type, and practice address. Set organization=true to search organizations (hospitals, clinics) instead of individual providers. The returned npi is what CMSOpenPayments_search_payments expects as its npi filter, resolving who a payment recipient actually is. No API key required.

Parameters:

  • terms (string) (required) Provider or organization name to search, e.g. ‘Smith’, ‘Mayo Clinic’.

  • organization ([‘boolean’, ‘null’]) (optional) Search organizations (hospitals, clinics) instead of individual providers. Default false.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "NPIProvider_search",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)

RxTerms_search_drugs (Type: ClinicalTablesTool)#

Drug-name autocomplete via the NLM Clinical Table Search Service (RxTerms). Given a partial or fu…

RxTerms_search_drugs tool specification

Tool Information:

  • Name: RxTerms_search_drugs

  • Type: ClinicalTablesTool

  • Description: Drug-name autocomplete via the NLM Clinical Table Search Service (RxTerms). Given a partial or full drug name, returns matching prescribable drug display names along with their available strengths and dose forms (e.g. ‘500 mg Tab’) and the corresponding RxNorm RxCUI identifiers. RxTerms is the consumer-/prescriber-friendly drug terminology derived from RxNorm. Use for medication entry, dose-form lookup, and resolving a drug name to RxCUIs for downstream RxNorm/interaction queries. No API key required.

Parameters:

  • terms (string) (required) Drug name or prefix to search, e.g. ‘metformin’, ‘atorvas’, ‘insulin aspart’.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "RxTerms_search_drugs",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)

StarAlleles_search (Type: ClinicalTablesTool)#

Pharmacogenomic star allele autocomplete via the NLM Clinical Table Search Service, e.g. CYP2D6*4…

StarAlleles_search tool specification

Tool Information:

  • Name: StarAlleles_search

  • Type: ClinicalTablesTool

  • Description: Pharmacogenomic star allele autocomplete via the NLM Clinical Table Search Service, e.g. CYP2D6*4. Given a gene or allele prefix, returns matching star allele designations with their defining nucleotide change, alternate/historical name, and resulting protein change. Complements the existing CPIC tools (which give dosing recommendations per diplotype but do not look up individual allele definitions). No API key required.

Parameters:

  • terms (string) (required) Gene or allele name/prefix to search, e.g. ‘CYP2D6’, ‘CYP2D6*4’.

  • max_results (integer) (optional) Maximum number of matches to return (default 20, max 500).

Example Usage:

query = {
    "name": "StarAlleles_search",
    "arguments": {
        "terms": "example_value"
    }
}
result = tu.run(query)