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)#

Search NLM disease names with official count+offset pagination. Returns canonical disease names w…

DiseaseNames_search tool specification

Tool Information:

  • Name: DiseaseNames_search

  • Type: ClinicalTablesTool

  • Description: Search NLM disease names with official count+offset pagination. Returns canonical disease names with UMLS CUIs in the code field. Response metadata exposes total_results, accessible_results, has_more, and next_offset; NLM caps retrieval at 7,500 matches.

Parameters:

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

  • max_results (integer) (optional) Page size (default 20, range 1-500).

  • offset (integer) (optional) Zero-based first match. Continue with metadata.next_offset; offset + max_results cannot exceed 7,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)#

Search the NLM conditions table with official count+offset pagination. Returns primary and consum…

HealthConditions_search tool specification

Tool Information:

  • Name: HealthConditions_search

  • Type: ClinicalTablesTool

  • Description: Search the NLM conditions table with official count+offset pagination. Returns primary and consumer condition names plus ICD-10-CM/ICD-9 crosswalks. Response metadata exposes total_results, accessible_results, has_more, and next_offset; NLM caps retrieval at 7,500 matches.

Parameters:

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

  • max_results (integer) (optional) Page size (default 20, range 1-500).

  • offset (integer) (optional) Zero-based first match. Continue with metadata.next_offset; offset + max_results cannot exceed 7,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)#

Search NLM RxTerms drug names with official count+offset pagination. Returns prescribable display…

RxTerms_search_drugs tool specification

Tool Information:

  • Name: RxTerms_search_drugs

  • Type: ClinicalTablesTool

  • Description: Search NLM RxTerms drug names with official count+offset pagination. Returns prescribable display names, strengths/forms, and RxNorm RxCUIs. Response metadata exposes total_results, accessible_results, has_more, and next_offset; NLM caps retrieval at 7,500 matches.

Parameters:

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

  • max_results (integer) (optional) Page size (default 20, range 1-500).

  • offset (integer) (optional) Zero-based first match. Continue with metadata.next_offset; offset + max_results cannot exceed 7,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)