tooluniverse-toxicology
Toxicology Assessment via Adverse Outcome Pathways & Signal Detection
Systematic toxicology analysis that links molecular initiating events (MIEs) through adverse outcome pathways (AOPs) to apical adverse outcomes, then triangulates with real-world FAERS signals, FDA label data, and toxicogenomic associations.
Domain Reasoning
Toxicity has many mechanisms, and the first interpretive question is temporal: is this acute toxicity (immediate effect from a high dose) or chronic toxicity (cumulative damage from long-term low-dose exposure)? Acute and chronic toxicity operate through different mechanisms — acute hepatotoxicity may reflect direct mitochondrial damage, while chronic hepatotoxicity may involve fibrosis from repeated low-level inflammation. They also have different regulatory frameworks: acute toxicity is captured by LD50 and emergency protocols, while chronic toxicity requires long-term carcinogenicity and repeat-dose studies.
LOOK UP DON'T GUESS
- Adverse outcome pathways for a chemical: query
AOPWiki_list_aopsandAOPWiki_get_aop; do not describe mechanisms from memory. - FAERS adverse event signals: retrieve from
FAERS_count_reactions_by_drug_eventandFAERS_calculate_disproportionality; never estimate PRR values. - FDA label warnings: call
DailyMed_parse_adverse_reactionsand related tools; do not state boxed warnings from memory. - CTD chemical-gene and chemical-disease associations: query
CTD_get_chemical_gene_interactionsandCTD_get_chemical_diseases; do not infer gene targets without database evidence.
COMPUTE, DON'T DESCRIBE
When analysis requires computation (statistics, data processing, scoring, enrichment), write and run Python code via Bash. Don't describe what you would do — execute it and report actual results. Use ToolUniverse tools to retrieve data, then Python (pandas, scipy, statsmodels, matplotlib) to analyze it.
When to Use This Skill
Triggers:
- "What are the toxicity mechanisms for [drug/chemical]?"
- "Find adverse outcome pathways for [chemical]"
- "What AOPs are relevant to [target/organ/effect]?"
- "FAERS signal analysis for [drug]"
- "Toxicogenomic profile for [chemical]"
- "What is the mechanism of hepatotoxicity / cardiotoxicity / neurotoxicity for [drug]?"
Use Cases:
- AOP Tracing: Map chemical MIE through key events to apical outcome using AOPWiki
- Real-World Signal Detection: Quantify FAERS adverse event signals with PRR/ROR
- Label Safety Mining: Extract FDA boxed warnings, contraindications, nonclinical toxicology
- Toxicogenomics: Chemical-gene-disease associations from CTD
- Integrated Mechanism Report: Combine AOP pathway + real-world signals into unified narrative
KEY PRINCIPLES
- AOP-first thinking - Frame all toxicity in terms of MIE → Key Events → Adverse Outcome
- Report-first approach - Create report file FIRST, update progressively
- Evidence grading mandatory - T1 (regulatory/clinical) through T4 (computational/AOP annotation)
- Distinguish mechanism from signal - AOPWiki = mechanism; FAERS = real-world signal
- Disambiguation first - Resolve drug/chemical identity before any queries
- English-first queries - Always use English names in tool calls
Evidence Grading
| Tier | Symbol | Criteria |
|---|---|---|
| T1 | [T1] | FDA boxed warning, clinical trial toxicity finding, regulatory label |
| T2 | [T2] | FAERS signal PRR > 2, AOP with high biological plausibility, CTD curated |
| T3 | [T3] | CTD inferred association, AOP annotation with moderate plausibility |
| T4 | [T4] | Text-mined CTD entry, early-stage AOP annotation |
Workflow Overview
Chemical/Drug Query
|
+-- PHASE 0: Disambiguation
| Resolve name -> identifiers (ChEMBL, PubChem CID, SMILES)
|
+-- PHASE 1: Adverse Outcome Pathway Mapping (AOPWiki)
| List AOPs by keyword; retrieve key events, MIEs, and biological plausibility scores
|
+-- PHASE 2: Real-World Adverse Event Signals (FAERS)
| Top reactions by drug; disproportionality (PRR); serious event filter
|
+-- PHASE 3: FDA Label Safety Mining
| Boxed warnings, contraindications, nonclinical toxicology, adverse reactions
|
+-- PHASE 4: Toxicogenomics (CTD)
| Chemical-gene interactions; chemical-disease associations
|
+-- SYNTHESIS: Integrated Toxicology Report
AOP-linked mechanism + FAERS signal + CTD gene targets + Risk classification
Phase 0: Disambiguation
Objective: Establish compound identity before any database queries.
Tools:
PubChem_get_CID_by_compound_name(name: str) — get CID + SMILESChEMBL_search_drugs(query: str) — get ChEMBL ID and max phase
Capture: generic name, SMILES, PubChem CID, ChEMBL ID, drug class.
Phase 1: Adverse Outcome Pathway Mapping
Objective: Find AOPs relevant to the chemical's known or suspected toxicity mechanisms.
Tools
AOPWiki_list_aops:
- Input:
keyword(str) — e.g., organ ("liver", "kidney"), effect ("apoptosis", "inflammation"), or target ("AhR", "PPARalpha") - Output: List of AOP IDs, titles, and short descriptions
- Use: Discovery scan to identify candidate AOPs
AOPWiki_get_aop:
- Input:
aop_id(int) — ID from list_aops result - Output: Full AOP details including MIE, key events (KEs), key event relationships (KERs), biological plausibility, and weight-of-evidence
- Use: Retrieve mechanistic pathway details for selected AOPs
Workflow
- Query
AOPWiki_list_aopswith organ-level keyword (e.g., "hepatotoxicity", "nephrotoxicity") - Query again with mechanism-level keyword (e.g., "oxidative stress", "mitochondria")
- Select top 3-5 most relevant AOPs by title relevance
- Call
AOPWiki_get_aopfor each selected AOP - Extract: MIE (molecular initiating event), key events in order, apical adverse outcome, biological plausibility score
Decision Logic
- AOP found: Extract full pathway; note plausibility level (high/moderate/low)
- No direct AOP match: Try broader organ or mechanism terms; document as "no AOP directly mapped"
- Multiple AOPs: Report all; highlight shared key events as high-confidence mechanisms
AOP Table Format
| AOP ID | Title | MIE | Apical Outcome | Plausibility |
|---|---|---|---|---|
| 123 | ... | ... | ... | High |
Phase 2: Real-World Adverse Event Signals (FAERS)
Objective: Quantify observed adverse events with statistical signal measures.
Tools
FAERS_count_reactions_by_drug_event:
- Input:
drug_name(str),limit(int, default 50) - Output: Top adverse reactions with counts
- Note: param is
drug_namenotdrug
FAERS_calculate_disproportionality:
- Input:
drug_name(str),reaction_meddra_pt(str) - Output: PRR, ROR, IC with confidence intervals
FAERS_filter_serious_events:
- Input:
drug_name(str),serious_type(str: "death", "hospitalization", "life-threatening") - Output: Serious event count and case details
FAERS_stratify_by_demographics:
- Input:
drug_name(str),reaction_meddra_pt(str) - Output: Age/sex breakdown for specific reaction
Workflow
- Get top 25 reactions via
FAERS_count_reactions_by_drug_event - Filter to organ-system clusters matching the AOP outcomes from Phase 1
- Calculate PRR for top 10 reactions via
FAERS_calculate_disproportionality - Check serious events (deaths, hospitalizations) for highest-PRR reactions
Signal Thresholds
| Signal Strength | PRR | Case Count |
|---|---|---|
| Strong | > 3.0 | >= 5 |
| Moderate | 2.0-3.0 | >= 3 |
| Weak | 1.5-2.0 | >= 3 |
| None | < 1.5 | any |
Phase 3: FDA Label Safety Mining
Objective: Extract regulatory safety findings from approved drug labels.
Tools
DailyMed_parse_adverse_reactions(drug_name: str)DailyMed_parse_contraindications(drug_name: str)DailyMed_parse_clinical_pharmacology(drug_name: str)DailyMed_parse_drug_interactions(drug_name: str)
Note: These tools apply to FDA-approved drugs only. Environmental chemicals will have no label data — document explicitly.
Workflow
- Extract adverse reactions and note which match FAERS signals
- Extract contraindications (highest evidence tier [T1])
- Note pharmacological mechanism from clinical pharmacology section
Phase 4: Toxicogenomics (CTD)
Objective: Map chemical-gene interactions and chemical-disease associations.
Tools
CTD_get_chemical_gene_interactions:
- Input:
input_terms(str) — chemical name or MeSH ID - Output: Gene targets with interaction type (increases/decreases expression)
- Use: Find molecular targets mediating toxicity
CTD_get_chemical_diseases:
- Input:
input_terms(str) — chemical name or MeSH ID - Output: Disease associations with evidence type (curated/inferred)
- Use: Find downstream disease endpoints
Workflow
- Query CTD with compound name; note curated (higher confidence) vs inferred entries
- Cross-reference gene targets with Phase 1 AOP key events
- Note which CTD disease endpoints match AOP apical outcomes
Synthesis: Integrated Toxicology Report
Structure:
# Toxicology Report: [Compound Name]
**Generated**: YYYY-MM-DD
## Executive Summary
Risk tier: CRITICAL / HIGH / MEDIUM / LOW / INSUFFICIENT DATA
Key finding summary (2-3 sentences)
## 1. Compound Identity
(disambiguation table)
## 2. Adverse Outcome Pathways [T3-T4]
(AOP table; pathway diagrams in text form)
## 3. Real-World Adverse Event Signals [T1-T2]
(FAERS top reactions + PRR table + serious events)
## 4. FDA Label Safety [T1]
(boxed warnings, contraindications, adverse reactions)
## 5. Toxicogenomics [T2-T4]
(CTD gene targets + disease associations)
## 6. Mechanistic Integration
(How AOP key events map to observed FAERS signals and CTD gene targets)
## 7. Risk Classification
(Final tier with rationale)
## Data Gaps & Limitations
(Missing data, confidence caveats)
Risk Classification
| Tier | Criteria |
|---|---|
| CRITICAL | FDA boxed warning OR FAERS PRR > 5 with deaths OR multiple T1 findings |
| HIGH | FAERS PRR 3-5 serious events OR FDA warning (non-boxed) OR high-plausibility AOP |
| MEDIUM | FAERS PRR 2-3 OR CTD curated associations OR moderate-plausibility AOP |
| LOW | All signals < PRR 2; no regulatory warnings; low-plausibility AOP only |
| INSUFFICIENT DATA | Fewer than 3 phases returned usable data |
Fallback Chains
| Primary Tool | Fallback 1 | Fallback 2 |
|---|---|---|
AOPWiki_list_aops |
Broaden keyword | Search by organ system |
FAERS_count_reactions_by_drug_event |
OpenFDA_search_drug_events |
Literature search |
DailyMed_parse_adverse_reactions |
OpenFDA_search_drug_events |
FAERS serious events |
CTD_get_chemical_diseases |
CTD_get_chemical_gene_interactions |
PubMed search |
Tool Parameter Reference (Critical)
| Tool | WRONG | CORRECT |
|---|---|---|
FAERS_count_reactions_by_drug_event |
drug |
drug_name |
AOPWiki_list_aops |
query |
keyword |
CTD_get_chemical_gene_interactions |
chemical |
input_terms |
CTD_get_chemical_diseases |
chemical |
input_terms |
Limitations
- AOPWiki: AOPs are in development; many lack high plausibility scores
- FAERS: Observational data; confounding by indication; underreporting bias
- CTD: Inferred associations have high false-positive rate
- DailyMed: FDA-approved drugs only; no environmental chemical coverage
- Environmental chemicals: Primarily Phase 1 (AOP) + Phase 4 (CTD) data available
References
- AOPWiki: https://aopwiki.org
- FAERS: https://www.fda.gov/drugs/questions-and-answers-fdas-adverse-event-reporting-system-faers
- CTD: http://ctdbase.org
- DailyMed: https://dailymed.nlm.nih.gov
- OpenFDA: https://open.fda.gov