Loinc Tools#

Configuration File: loinc_tools.json Tool Type: Local Tools Count: 4

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

Available Tools#

LOINC_get_answer_list (Type: LOINCTool)#

Get the answer lists published for a LOINC code – the permissible coded values a list-type obser…

LOINC_get_answer_list tool specification

Tool Information:

  • Name: LOINC_get_answer_list

  • Type: LOINCTool

  • Description: Get the answer lists published for a LOINC code – the permissible coded values a list-type observation may take, such as Group A / Group B / Group O / Group AB for ABO group, or the four PHQ frequency options. Returns each matching LOINC code together with its answer lists (answer code, display text, sequence and score where scored) and its datatype. Codes whose datatype is not CNE or CWE take a free value rather than an answer from a list, and correctly return no answer list; answer_lists_found reports how many of the matched codes had one.

Parameters:

  • loinc_code (string) (required) LOINC code whose answer lists you want (e.g. ‘883-9’ for ABO group, ‘44250-9’ for a PHQ-9 item). A search term such as ‘ABO’ or ‘blood type’ also works and returns the answer lists of every code it matches.

Example Usage:

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

LOINC_get_code_details (Type: LOINCTool)#

Get detailed information for a specific LOINC code including full name, component, property, syst…

LOINC_get_code_details tool specification

Tool Information:

  • Name: LOINC_get_code_details

  • Type: LOINCTool

  • Description: Get detailed information for a specific LOINC code including full name, component, property, system, scale, method, and clinical classification. Use this to understand the precise meaning and context of a LOINC code obtained from lab results or clinical data.

Parameters:

  • loinc_code (string) (required) LOINC code identifier (e.g., ‘2093-3’ for Cholesterol in Serum/Plasma, ‘4548-4’ for Hemoglobin A1c, ‘8867-4’ for Heart rate). The code should be in standard LOINC format with hyphen.

Example Usage:

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

LOINC_search_forms (Type: LOINCTool)#

Search LOINC clinical forms, panels and survey instruments – whole instruments, not their indivi…

LOINC_search_forms tool specification

Tool Information:

  • Name: LOINC_search_forms

  • Type: LOINCTool

  • Description: Search LOINC clinical forms, panels and survey instruments – whole instruments, not their individual questions. Examples include PHQ-9 (depression), GAD-7 (anxiety), MMSE (cognitive), pain assessment panels and laboratory panels such as the comprehensive metabolic panel. Returns the LOINC code of each matching instrument, for use in electronic health records. A single question or lab test will not be returned here even when its wording matches the search terms – use LOINC_search_tests for those.

Parameters:

  • terms (string) (required) Search terms naming a clinical form, panel or survey instrument (e.g. ‘PHQ-9’, ‘GAD-7’, ‘MMSE’, ‘pain’, ‘depression’, ‘comprehensive metabolic’). Terms are matched against instrument names, so a broad clinical phrase that is not part of any instrument’s name (e.g. ‘depression screening’) can legitimately return nothing.

  • max_results (integer) (optional) Maximum number of results to return (default: 20, max: 200)

Example Usage:

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

LOINC_search_tests (Type: LOINCTool)#

Search LOINC (Logical Observation Identifiers Names and Codes) lab tests and clinical observation…

LOINC_search_tests tool specification

Tool Information:

  • Name: LOINC_search_tests

  • Type: LOINCTool

  • Description: Search LOINC (Logical Observation Identifiers Names and Codes) lab tests and clinical observations by name or keywords. Returns standardized codes for laboratory tests, vital signs, and clinical measurements. Essential for standardizing lab test names across healthcare systems and research studies.

Parameters:

  • terms (string) (required) Search terms for lab tests or observations (e.g., ‘cholesterol’, ‘blood glucose’, ‘hemoglobin’, ‘creatinine’). Can include test names, components, or abbreviations.

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

  • exclude_copyrighted (boolean) (optional) Exclude items with external copyright notices (default: true)

Example Usage:

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