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 – using NLM’s type=form endpoint. 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. Uses count+offset pagination; response metadata exposes exact continuation and the upstream 7,500-result retrieval window.

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) Page size (default 20, range 1-500).

  • offset (integer) (optional) Zero-based first form. Continue with metadata.next_offset; offset + max_results cannot exceed 7,500.

Example Usage:

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

LOINC_search_tests (Type: LOINCTool)#

Search LOINC lab tests and clinical observations with the NLM Clinical Tables count+offset pagina…

LOINC_search_tests tool specification

Tool Information:

  • Name: LOINC_search_tests

  • Type: LOINCTool

  • Description: Search LOINC lab tests and clinical observations with the NLM Clinical Tables count+offset pagination API. Returns standardized codes and display fields. Response metadata exposes total_results, accessible_results, has_more, and next_offset; NLM limits retrieval to the first 7,500 matches and upstream_truncated explicitly reports when refinement is required.

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) Page size (default 20, range 1-500). Sent as count; maxList does not support pagination.

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