Clinical Guidelines Tools#

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

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

Available Tools#

DailyMed_search_drug_classes (Type: DailyMedDrugClassesTool)#

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: DailyMedDrugClassesTool

  • 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. metadata.total_matches is the exact number of matching classes across the whole catalogue; request further pages with page while page * pagesize < total_matches.

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 matching classes per page (1-100; default: 100).

  • page (integer) (optional) One-based page number of the matches (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: MAGICappGuidelineListTool)#

Find clinical practice guidelines on MAGICapp (Making GRADE the Irresistible Choice), the platfor…

MAGICapp_list_guidelines tool specification

Tool Information:

  • Name: MAGICapp_list_guidelines

  • Type: MAGICappGuidelineListTool

  • Description: Find clinical practice guidelines on MAGICapp (Making GRADE the Irresistible Choice), the platform for GRADE-based living guidelines of WHO (including maternal and perinatal health), BMJ Rapid Recommendations / MAGIC, the European Stroke Organisation, Cancer Council Australia, EAES and other societies: about 460 public guidelines, half in English. Give query words (a condition, intervention or organization, e.g. ‘stroke thrombolysis’, ‘postpartum haemorrhage’, ‘WHO tuberculosis’); a guideline matches when its name, organization or description holds every word (word beginnings: ‘pregnan’ finds pregnancy), and when none holds them all the guidelines holding most of them are returned and metadata.matched_by says so. language filters by code (‘en’ also matches ‘en-gb’). Without a query, lists guidelines newest first. Returns each guideline’s publishedId, name, owner, language, publication date, number of published recommendations and link, with metadata.matching and next_offset for paging (limit at most 100). Pass publishedId (not guidelineId, the unpublished draft) as guideline_id to MAGICapp_get_recommendations for the GRADE-rated recommendation statements, or to MAGICapp_get_sections / MAGICapp_get_guideline.

Parameters:

  • query ([‘string’, ‘null’]) (optional) Words to find in a guideline’s name, organization or description, e.g. ‘stroke thrombolysis’ or ‘WHO maternal’. Omit to list all.

  • language ([‘string’, ‘null’]) (optional) Language code to keep, e.g. ‘en’ (also matches ‘en-gb’), ‘nl’, ‘dk’. Omit for all languages.

  • limit ([‘integer’, ‘null’]) (optional) Guidelines to return (default 20, at most 100).

  • offset ([‘integer’, ‘null’]) (optional) Matching guidelines to skip, for paging (metadata.next_offset).

Example Usage:

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

NCI_expand_drugs_by_letter (Type: BaseRESTTool)#

Browse one page of the NCI Drug Dictionary by first letter. The response includes an exact total …

NCI_expand_drugs_by_letter tool specification

Tool Information:

  • Name: NCI_expand_drugs_by_letter

  • Type: BaseRESTTool

  • Description: Browse one page of the NCI Drug Dictionary by first letter. The response includes an exact total and offset navigation metadata; continue with metadata.next_offset, passing it as from/from_ in the generated wrapper, while metadata.has_more is true. Use NCI_get_drug_by_name with prettyUrlName for 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) Zero-based record offset (generated Python wrapper name: from_). Continue with metadata.next_offset.

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)