Sider Tools#

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

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

Available Tools#

SIDER_get_drug_indications (Type: SiderTool)#

Get the therapeutic indications for a drug from SIDER. Indications are medical conditions that a …

SIDER_get_drug_indications tool specification

Tool Information:

  • Name: SIDER_get_drug_indications

  • Type: SiderTool

  • Description: Get the therapeutic indications for a drug from SIDER. Indications are medical conditions that a drug is approved to treat, extracted from the indications and usage sections of drug labels. Returns MedDRA-coded conditions with descriptions. Provide either a drug name or SIDER drug ID.

Parameters:

  • operation (string) (optional) Operation type

  • drug_name ([‘string’, ‘null’]) (optional) Drug name (e.g., ‘aspirin’, ‘metformin’). Will search SIDER and use first match.

  • sider_drug_id ([‘string’, ‘null’]) (optional) SIDER drug ID (PubChem CID) from SIDER_search_drug (e.g., ‘2244’ for aspirin)

Example Usage:

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

SIDER_get_drug_side_effects (Type: SiderTool)#

Get the list of known side effects for a drug from SIDER, including frequency data when available…

SIDER_get_drug_side_effects tool specification

Tool Information:

  • Name: SIDER_get_drug_side_effects

  • Type: SiderTool

  • Description: Get the list of known side effects for a drug from SIDER, including frequency data when available. Side effects are extracted from drug labels and include MedDRA codes, the frequency reported for the drug (e.g., ‘21% - 57.5%’, ‘6%’, or qualitative terms such as ‘postmarketing’ or ‘rare’), and the placebo-arm rate when the label reports one. Most SIDER labels have no placebo arm, so placebo_frequency is null for the majority of side effects; null means SIDER has no placebo rate, not that the placebo rate is zero or equal to the drug’s rate. Frequency values are label-derived, not incidence estimates for an unselected population. Results use exact, recoverable local pagination over the complete parsed drug page: metadata.total_matches is exact when source_parse_complete is true; continue with next_offset while has_more is true. Provide exactly one of drug_name (will auto-search) or a SIDER drug ID from SIDER_search_drug. Returns adverse reactions recorded in official drug labels.

Parameters:

  • operation (string) (optional) Operation type

  • drug_name ([‘string’, ‘null’]) (optional) Drug name (e.g., ‘ibuprofen’, ‘metformin’). Will search SIDER and use first match. Mutually exclusive with sider_drug_id.

  • sider_drug_id ([‘string’, ‘null’]) (optional) SIDER drug ID (PubChem CID) from SIDER_search_drug results (e.g., ‘3672’ for ibuprofen, ‘4091’ for metformin)

  • limit (integer) (optional) Maximum side effects on this page (default: 50)

  • offset (integer) (optional) Zero-based offset into the exact parsed side-effect set; continue with metadata.next_offset

Example Usage:

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

SIDER_get_drugs_for_side_effect (Type: SiderTool)#

Find unique drugs associated with one SIDER side effect using exact, recoverable local pagination…

SIDER_get_drugs_for_side_effect tool specification

Tool Information:

  • Name: SIDER_get_drugs_for_side_effect

  • Type: SiderTool

  • Description: Find unique drugs associated with one SIDER side effect using exact, recoverable local pagination over the complete side-effect page. Duplicate source rows for one drug ID are merged without discarding distinct frequency strings; metadata exposes source_association_rows and duplicate_source_rows. Continue with next_offset while has_more is true. Provide exactly one of meddra_code or side_effect_name.

Parameters:

  • operation (string) (optional) Operation type

  • meddra_code ([‘string’, ‘null’]) (optional) MedDRA concept code / UMLS CUI (e.g., ‘C0018681’ for headache, ‘C0027497’ for nausea)

  • side_effect_name ([‘string’, ‘null’]) (optional) Side effect name to search (e.g., ‘headache’, ‘nausea’, ‘diarrhea’). Will search SIDER and use first match.

  • limit (integer) (optional) Maximum drugs on this page (default: 50)

  • offset (integer) (optional) Zero-based offset into the exact drug association set; continue with metadata.next_offset

Example Usage:

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

SIDER_search_drug (Type: SiderTool)#

Search the SIDER drug side effects database for a drug by name. Returns matching drugs with SIDER…

SIDER_search_drug tool specification

Tool Information:

  • Name: SIDER_search_drug

  • Type: SiderTool

  • Description: Search the SIDER drug side effects database for a drug by name. Returns matching drugs with SIDER IDs and any related side effects. SIDER contains adverse drug reaction data extracted from drug labels for marketed medicines. Use this to find the SIDER drug ID needed for other SIDER operations (get_side_effects, get_indications).

Parameters:

  • operation (string) (optional) Operation type

  • drug_name (string) (required) Drug name to search for (e.g., ‘aspirin’, ‘ibuprofen’, ‘metformin’, ‘warfarin’)

Example Usage:

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

SIDER_search_side_effect (Type: SiderTool)#

Search for a side effect by name in SIDER and return matching MedDRA/UMLS codes. drug_count is on…

SIDER_search_side_effect tool specification

Tool Information:

  • Name: SIDER_search_side_effect

  • Type: SiderTool

  • Description: Search for a side effect by name in SIDER and return matching MedDRA/UMLS codes. drug_count is only the upstream search suggestion’s reported count and is explicitly marked non-exact because it can disagree with unique drug IDs on the detail page; call SIDER_get_drugs_for_side_effect for an exact unique count and pagination.

Parameters:

  • operation (string) (optional) Operation type

  • side_effect_name (string) (required) Side effect name to search (e.g., ‘headache’, ‘nausea’, ‘diarrhea’, ‘liver’)

Example Usage:

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