Rxclass Tools

Configuration File: rxclass_tools.json Tool Type: Local Tools Count: 5

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

Available Tools

RxClass_find_classes (Type: RxClassTool)

Search NLM RxClass drug classification database by keyword. Returns matching class IDs, names, an…

RxClass_find_classes tool specification

Tool Information:

  • Name: RxClass_find_classes

  • Type: RxClassTool

  • Description: Search NLM RxClass drug classification database by keyword. Returns matching class IDs, names, and types (ATC, EPC, MoA, etc.). No API key required. Example: query=’analgesic’ returns pain-related drug classes; query=’beta blocker’ returns adrenergic receptor blocker classes.

Parameters:

  • query (string) (required) Keyword to search in class names. Examples: ‘analgesic’, ‘beta blocker’, ‘antidiabetic’, ‘statin’, ‘NSAID’, ‘ACE inhibitor’.

  • class_type ([‘string’, ‘null’]) (optional) Filter by class type. Options: ‘ATC1-4’ (ATC codes), ‘EPC’ (Established Pharmacologic Class), ‘MOA’ (Mechanism of Action), ‘PE’ (Physiologic Effect), ‘DISEASE’, ‘VA’, ‘SCHEDULE’.

  • limit ([‘integer’, ‘null’]) (optional) Maximum results to return (default 20).

Example Usage:

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

RxClass_get_class_hierarchy (Type: RxClassTool)

Traverse the drug-class hierarchy (ancestor chain / class tree) for a class ID in NLM RxClass via…

RxClass_get_class_hierarchy tool specification

Tool Information:

  • Name: RxClass_get_class_hierarchy

  • Type: RxClassTool

  • Description: Traverse the drug-class hierarchy (ancestor chain / class tree) for a class ID in NLM RxClass via classGraph. Returns the ordered parent chain from a leaf class up to the classification root, with all nodes (classId, className, classType) and edges (child isa parent), plus a precomputed ‘ancestor_path’ from the requested class to the root. Default source is ATC. No API key required. Example: classId ‘N02BA’ (‘Salicylic acid and derivatives’) -> N02BA <- N02B (‘OTHER ANALGESICS AND ANTIPYRETICS’) <- N02 (‘ANALGESICS’) <- N (‘NERVOUS SYSTEM’) <- 0 (‘Anatomical Therapeutic Chemical’ root), 5 nodes / 4 edges.

Parameters:

  • class_id (string) (required) Drug class identifier whose ancestor chain to traverse. ATC class codes: ‘N02BA’ (salicylic acid derivatives), ‘M01AE’ (propionic acid derivatives), ‘A10BA’ (biguanides), ‘C09AA’ (ACE inhibitors).

  • source ([‘string’, ‘null’]) (optional) Optional classification source/vocabulary for the graph. Default: ATC (the API default when omitted). Most ATC class IDs do not require this.

Example Usage:

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

RxClass_get_class_members (Type: RxClassTool)

List all drugs belonging to a specific drug class by class ID in NLM RxClass. Returns RXCUIs and …

RxClass_get_class_members tool specification

Tool Information:

  • Name: RxClass_get_class_members

  • Type: RxClassTool

  • Description: List all drugs belonging to a specific drug class by class ID in NLM RxClass. Returns RXCUIs and drug names for all member ingredients. No API key required. Example: classId=’M01AE’ (propionic acid derivatives) returns ibuprofen, naproxen, ketoprofen, etc.

Parameters:

  • class_id (string) (required) Drug class identifier. ATC class codes: ‘M01AE’ (propionic acid derivatives), ‘N02BA’ (salicylic acid derivatives), ‘A10BA’ (biguanides). FDA EPC IDs are long numeric strings.

  • rela_source ([‘string’, ‘null’]) (optional) Classification source system. Options: ‘ATC’ (default), ‘FDASPL’, ‘MESH’, ‘VA’, ‘DAILYMED’.

  • ttys ([‘string’, ‘null’]) (optional) RxNorm term types to include. Options: ‘IN’ (ingredients, default), ‘PIN’ (precise ingredients), ‘MIN’ (multi-ingredients), ‘SCD’ (semantic clinical drugs). Default: ‘IN’.

  • limit ([‘integer’, ‘null’]) (optional) Maximum number of drugs to return (default 50).

Example Usage:

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

RxClass_get_disease_relations (Type: RxClassTool)

Get MED-RT drug<->disease relations (may_treat, may_prevent, CI_with, induces, has_PE) from NLM R…

RxClass_get_disease_relations tool specification

Tool Information:

  • Name: RxClass_get_disease_relations

  • Type: RxClassTool

  • Description: Get MED-RT drug<->disease relations (may_treat, may_prevent, CI_with, induces, has_PE) from NLM RxClass, in either direction. FORWARD: pass ‘drug_name’ or ‘rxcui’ to get the MED-RT disease classes a drug relates to (e.g. drug_name=’albuterol’, rela=’may_treat’ -> Asthma D001249, Bronchial Spasm D001986). REVERSE: pass ‘class_id’ (a MeSH-style disease class ID) to list all ingredient drugs that relate to that disease (e.g. class_id=’D001249’ (Asthma), rela=’may_treat’ -> terbutaline, theophylline, zafirlukast, … 42 ingredients). Uses relaSource=MEDRT which the standard drug-class tool does not expose. No API key required.

Parameters:

  • drug_name ([‘string’, ‘null’]) (optional) Forward lookup: drug name. Examples: ‘albuterol’, ‘aspirin’, ‘metoprolol’. Provide this OR ‘rxcui’ OR ‘class_id’.

  • rxcui ([‘string’, ‘null’]) (optional) Forward lookup: RxNorm RXCUI (alternative to drug_name).

  • class_id ([‘string’, ‘null’]) (optional) Reverse lookup: MED-RT/MeSH disease class ID to find all related drugs for. Examples: ‘D001249’ (Asthma), ‘D001986’ (Bronchial Spasm), ‘D003920’ (Diabetes Mellitus).

  • rela ([‘string’, ‘null’]) (optional) MED-RT relationship to filter on. Options: ‘may_treat’, ‘may_prevent’, ‘CI_with’ (contraindicated with), ‘induces’, ‘has_PE’ (has physiologic effect), ‘has_MoA’, ‘has_EPC’. Default: all relations.

  • ttys ([‘string’, ‘null’]) (optional) Reverse lookup only: RxNorm term types for returned drugs. Options: ‘IN’ (ingredients, default), ‘PIN’, ‘MIN’, ‘SCD’. Default: ‘IN’.

Example Usage:

query = {
    "name": "RxClass_get_disease_relations",
    "arguments": {
    }
}
result = tu.run(query)

RxClass_get_drug_classes (Type: RxClassTool)

Get drug classification from NLM RxClass for a drug name or RXCUI. Returns ATC codes, EPC (Establ…

RxClass_get_drug_classes tool specification

Tool Information:

  • Name: RxClass_get_drug_classes

  • Type: RxClassTool

  • Description: Get drug classification from NLM RxClass for a drug name or RXCUI. Returns ATC codes, EPC (Established Pharmacologic Class), MoA, VA drug classes, and more. No API key required. Example: ‘metformin’ -> ATC A10BA02 (biguanides); ‘aspirin’ -> ATC N02BA01, EPC ‘Platelet Aggregation Inhibitor’.

Parameters:

  • drug_name ([‘string’, ‘null’]) (optional) Drug name to classify. Examples: ‘metformin’, ‘aspirin’, ‘ibuprofen’, ‘metoprolol’.

  • rxcui ([‘string’, ‘null’]) (optional) RxNorm RXCUI identifier (alternative to drug_name). Examples: ‘6809’ (metformin), ‘1191’ (aspirin).

  • rela_source ([‘string’, ‘null’]) (optional) Classification source. Options: ‘ATC’ (WHO Anatomical Therapeutic Chemical, default), ‘FDASPL’ (FDA pharmacologic classes including EPC/MoA/PE), ‘MESH’, ‘VA’, ‘DAILYMED’, ‘ALL’. Default: ‘ATC’.

  • limit ([‘integer’, ‘null’]) (optional) Maximum results to return (default 20).

Example Usage:

query = {
    "name": "RxClass_get_drug_classes",
    "arguments": {
    }
}
result = tu.run(query)