Clinical Guidelines Tools

Configuration File: clinical_guidelines_tools.json Tool Type: Local Tools Count: 8

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

Available Tools

DailyMed_search_drug_classes (Type: BaseRESTTool)

Search the DailyMed database for FDA Established Pharmacologic Classes (EPC). Returns drug class …

DailyMed_search_drug_classes tool specification

Tool Information:

  • Name: DailyMed_search_drug_classes

  • Type: BaseRESTTool

  • Description: Search the DailyMed database for FDA Established Pharmacologic Classes (EPC). Returns drug class names and NDF-RT codes that categorize drugs by their mechanism of action or pharmacologic effect. Use this to find drug classes for a specific therapeutic area (e.g., ‘antihypertensive’, ‘antibiotic’, ‘antineoplastic’) or to look up specific pharmacologic class codes. The drug class codes can be used to search DailyMed_search_spls for all drugs in that class.

Parameters:

  • drug_class_name (string) (required) Search term for drug class name (e.g., ‘anti’, ‘kinase inhibitor’, ‘antibacterial’, ‘antineoplastic’, ‘angiotensin’)

  • pagesize (integer) (optional) Number of results per page (default: 100)

  • page (integer) (optional) Page number for pagination (default: 1)

Example Usage:

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

MAGICapp_get_guideline (Type: BaseRESTTool)

Get detailed information about a specific clinical guideline from MAGICapp by its numeric guideli…

MAGICapp_get_guideline tool specification

Tool Information:

  • Name: MAGICapp_get_guideline

  • Type: BaseRESTTool

  • Description: Get detailed information about a specific clinical guideline from MAGICapp by its numeric guideline ID. Returns comprehensive guideline metadata including title, authoring organization, contact information, version details, GRADE methodology settings, and links to PDF/JSON exports. Use MAGICapp_list_guidelines first to find guideline IDs, then use this tool to get full details. For the guideline’s clinical recommendations, use MAGICapp_get_recommendations instead.

Parameters:

  • guideline_id (integer) (required) Numeric guideline ID (use the publishedId from MAGICapp_list_guidelines, e.g., 10962, 10258, 7594)

Example Usage:

query = {
    "name": "MAGICapp_get_guideline",
    "arguments": {
        "guideline_id": 10
    }
}
result = tu.run(query)

MAGICapp_get_recommendations (Type: BaseRESTTool)

Get all clinical recommendations from a specific MAGICapp guideline. Returns GRADE-rated recommen…

MAGICapp_get_recommendations tool specification

Tool Information:

  • Name: MAGICapp_get_recommendations

  • Type: BaseRESTTool

  • Description: Get all clinical recommendations from a specific MAGICapp guideline. Returns GRADE-rated recommendations with strength levels (STRONG, WEAK, PRACTICE, NO_STRENGTH), recommendation text (HTML), supporting remarks, rationale, and key information including evidence quality assessments. This is the core tool for accessing evidence-based clinical recommendations from living guidelines hosted on MAGICapp. Use MAGICapp_list_guidelines first to find guideline IDs.

Parameters:

  • guideline_id (integer) (required) Numeric guideline ID (use the publishedId from MAGICapp_list_guidelines, e.g., 10962 for oral cancer screening, 10258 for WHO mpox guidelines)

Example Usage:

query = {
    "name": "MAGICapp_get_recommendations",
    "arguments": {
        "guideline_id": 10
    }
}
result = tu.run(query)

MAGICapp_get_sections (Type: BaseRESTTool)

Get all sections (chapters) of a specific MAGICapp clinical guideline. Returns the structural org…

MAGICapp_get_sections tool specification

Tool Information:

  • Name: MAGICapp_get_sections

  • Type: BaseRESTTool

  • Description: Get all sections (chapters) of a specific MAGICapp clinical guideline. Returns the structural organization of the guideline including section headings, text content, section types, and hierarchical ordering. Use this to understand the guideline’s structure and find specific clinical topics within a guideline. Sections contain the narrative text while recommendations are accessed separately via MAGICapp_get_recommendations.

Parameters:

  • guideline_id (integer) (required) Numeric guideline ID (use the publishedId from MAGICapp_list_guidelines, e.g., 10962 for oral cancer screening, 10258 for WHO mpox guidelines)

Example Usage:

query = {
    "name": "MAGICapp_get_sections",
    "arguments": {
        "guideline_id": 10
    }
}
result = tu.run(query)

MAGICapp_list_guidelines (Type: BaseRESTTool)

List all publicly available clinical guidelines from MAGICapp (Making GRADE the Irresistible Choi…

MAGICapp_list_guidelines tool specification

Tool Information:

  • Name: MAGICapp_list_guidelines

  • Type: BaseRESTTool

  • Description: List all publicly available clinical guidelines from MAGICapp (Making GRADE the Irresistible Choice). MAGICapp hosts GRADE-based living guidelines from organizations like WHO, Stroke Foundation, American Dental Association, and others. Returns guideline metadata including name, owner organization, publication date, recommendation count, and guideline IDs for detailed lookups. Use this tool to discover available evidence-based clinical guidelines, then use MAGICapp_get_guideline or MAGICapp_get_recommendations for details.

Parameters:

No parameters required.

Example Usage:

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

NCI_expand_drugs_by_letter (Type: BaseRESTTool)

Browse the NCI Drug Dictionary by first letter. Returns all cancer drugs and drug aliases startin…

NCI_expand_drugs_by_letter tool specification

Tool Information:

  • Name: NCI_expand_drugs_by_letter

  • Type: BaseRESTTool

  • Description: Browse the NCI Drug Dictionary by first letter. Returns all cancer drugs and drug aliases starting with the specified letter. Each result includes the drug name, preferred name, type (DrugTerm or DrugAlias), and a pretty URL name for detailed lookups. Useful for discovering cancer drugs alphabetically or finding all drugs starting with a specific letter. Use NCI_get_drug_by_name with the prettyUrlName to get full details.

Parameters:

  • letter (string) (required) First letter to browse by (a-z, or ‘#’ for drugs starting with numbers/special characters)

  • size (integer) (optional) Number of results per page (default: 100, max: 10000)

  • from (integer) (optional) Offset for pagination (default: 0)

Example Usage:

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

NCI_get_drug_by_name (Type: BaseRESTTool)

Get detailed information about a cancer drug from the NCI Drug Dictionary by its pretty-url-name …

NCI_get_drug_by_name tool specification

Tool Information:

  • Name: NCI_get_drug_by_name

  • Type: BaseRESTTool

  • Description: Get detailed information about a cancer drug from the NCI Drug Dictionary by its pretty-url-name (slug). Returns comprehensive drug information including definition, aliases (brand names, chemical names, code names, CAS registry numbers), NCI concept ID, and links to drug information summaries. The pretty-url-name is a lowercase hyphenated slug (e.g., ‘pembrolizumab’, ‘tamoxifen-citrate’, ‘nivolumab’). You can find drug names from NCIDrugDict_search results (prettyUrlName field).

Parameters:

  • drug_name (string) (required) Pretty URL name (slug) of the drug (e.g., ‘pembrolizumab’, ‘tamoxifen-citrate’, ‘nivolumab’, ‘trastuzumab’)

Example Usage:

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

NCI_search_cancer_resources (Type: BaseRESTTool)

Search NCI (National Cancer Institute) Resources for Researchers (R4R) for cancer research tools,…

NCI_search_cancer_resources tool specification

Tool Information:

  • Name: NCI_search_cancer_resources

  • Type: BaseRESTTool

  • Description: Search NCI (National Cancer Institute) Resources for Researchers (R4R) for cancer research tools, databases, datasets, and clinical research resources. The R4R collection includes bioinformatics tools, clinical research tools, lab instruments, datasets, specimen repositories, and community resources. Returns resource descriptions, links, tool types, research areas, and research types. Useful for finding cancer-specific research resources, analysis tools, and clinical resources.

Parameters:

  • q (string) (required) Search query for cancer research resources (e.g., ‘breast cancer treatment’, ‘genomics analysis’, ‘clinical trial design’)

  • size (integer) (optional) Number of results to return (default: 20, max: 50)

  • from (integer) (optional) Offset for pagination (default: 0)

  • toolTypes (string) (optional) Filter by tool type key: ‘analysis_tools’, ‘datasets_databases’, ‘lab_tools’, ‘community_research_tools’, ‘clinical_research_tools’, ‘terminology’

  • researchAreas (string) (optional) Filter by research area key: ‘cancer_treatment’, ‘cancer_biology’, ‘cancer_omics’, ‘screening_detection’, ‘causes_of_cancer’, ‘cancer_health_disparities’, ‘cancer_statistics’, ‘cancer_prevention’, ‘cancer_diagnosis’, ‘cancer_survivorship’

Example Usage:

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