Loading...
Loading...
Drug mechanism of action investigation -- systematic strategy to trace a drug from its primary target through pathways to clinical outcomes, identify off-target effects, and combine regulatory labels with literature evidence for a complete mechanism picture.
npx skill4agent add mims-harvard/tooluniverse tooluniverse-drug-mechanism-researchtooluniverse-adverse-event-detectiontooluniverse-drug-repurposingtooluniverse-drug-target-validationtooluniverse-network-pharmacologytooluniverse-pharmacogenomics# Resolve drug name to ChEMBL ID
result = tu.tools.OpenTargets_get_drug_id_description_by_name(drugName="metformin")
# Alternative: OpenTargets_get_drug_chembId_by_generic_name(drugName="metformin")
# Get PharmGKB ID (needed for PGx queries)
result = tu.tools.PharmGKB_search_drugs(query="metformin")PharmGKB_search_drugsChEMBL_get_drug# OpenTargets: quick summary of MOA with target gene symbols
moa = tu.tools.OpenTargets_get_drug_mechanisms_of_action_by_chemblId(chemblId="CHEMBL1431")
for row in moa["data"]["drug"]["mechanismsOfAction"]["rows"]:
print(f"{row['mechanismOfAction']} ({row['actionType']}) -> {row['targetName']}")
for t in row.get("targets", []):
print(f" Target gene: {t['approvedSymbol']} ({t['id']})")
# ChEMBL: detailed MOA with literature references and direct_interaction flag
mechs = tu.tools.ChEMBL_get_drug_mechanisms(drug_chembl_id__exact="CHEMBL1431")
for m in mechs["data"]["mechanisms"]:
print(f"MOA: {m['mechanism_of_action']}, Direct: {m['direct_interaction']}")
print(f" Refs: {[r['ref_id'] for r in m.get('mechanism_refs', [])]}")OpenTargets_get_associated_targets_by_drug_chemblId# ChEMBL bioactivity data shows binding affinity across targets
activities = tu.tools.ChEMBL_get_target_activities(target_chembl_id__exact="CHEMBL2364")
# STRING interaction partners reveal the target's protein network
partners = tu.tools.STRING_get_interaction_partners(identifiers="PRKAA1", species=9606)# KEGG: find gene ID, then get pathways
genes = tu.tools.kegg_find_genes(keyword="PRKAA1", organism="hsa")
pathways = tu.tools.KEGG_get_gene_pathways(gene_id="hsa:5562")
# Reactome: map protein to pathways (needs UniProt ID)
reactome = tu.tools.Reactome_map_uniprot_to_pathways(uniprot_id="Q13131")
# WikiPathways: search by gene symbol
wp = tu.tools.WikiPathways_find_pathways_by_gene(gene="PRKAA1")
# STRING: functional annotations (GO terms, pathway memberships)
annot = tu.tools.STRING_get_functional_annotations(identifiers="PRKAA1", species=9606)# Reactome enrichment (space-separated gene list, NOT array)
enrichment = tu.tools.ReactomeAnalysis_pathway_enrichment(identifiers="PRKAA1 PRKAA2 PRKAB1")
# STRING enrichment
enrichment = tu.tools.STRING_functional_enrichment(identifiers="PRKAA1 PRKAA2", species=9606)setid# Step 1: Get setid
spls = tu.tools.DailyMed_search_spls(drug_name="metformin")
setid = spls["data"][0]["setid"]
# Step 2: Parse the clinical pharmacology section (MOA, PK/PD, metabolism)
pharmacology = tu.tools.DailyMed_parse_clinical_pharmacology(
operation="parse_clinical_pharmacology", setid=setid)
# Drug interactions from the label
interactions = tu.tools.DailyMed_parse_drug_interactions(
operation="parse_drug_interactions", setid=setid)
# Contraindications
contra = tu.tools.DailyMed_parse_contraindications(
operation="parse_contraindications", setid=setid)DailyMed_parse_adverse_reactionsDailyMed_parse_dosing# CPIC gene-drug pairs (gold standard for PGx)
pairs = tu.tools.CPIC_search_gene_drug_pairs(gene_symbol="CYP2C19", cpiclevel="A", limit=20)
# Or search by drug
drug_info = tu.tools.CPIC_get_drug_info(name="clopidogrel")
# FDA PGx biomarkers (what's on the label)
fda_pgx = tu.tools.fda_pharmacogenomic_biomarkers(drug_name="clopidogrel", limit=100)
# Or find all drugs affected by a gene
fda_pgx = tu.tools.fda_pharmacogenomic_biomarkers(biomarker="CYP2D6", limit=100)
# PharmGKB gene details
gene_info = tu.tools.PharmGKB_search_genes(query="CYP2C19")# PubMed: returns a plain list of article dicts
articles = tu.tools.PubMed_search_articles(
query="metformin mechanism of action AMPK mitochondrial", limit=10)
# EuropePMC: returns {status, data, metadata}
articles = tu.tools.EuropePMC_search_articles(
query="metformin mechanism action mitochondrial", limit=10)
# Follow citation chains for seminal papers
citations = tu.tools.EuropePMC_get_citations(source="MED", identifier="12345678")## Drug Mechanism Report: [Drug Name]
### Drug Identity
- ChEMBL ID, PharmGKB ID, approval status
### Primary Mechanism
- Target: [gene symbol], Action: [INHIBITOR/AGONIST/etc.]
- Mechanism narrative (from DailyMed + databases)
- Direct interaction: yes/no
### Off-Target Effects
- Additional targets with action types and binding affinities
- Which off-targets explain known side effects
### Pathway Context
- Key pathways (from KEGG/Reactome/WikiPathways)
- Upstream vs downstream position of target
- Convergent pathways for multi-target drugs
### Pharmacogenomics
- CPIC gene-drug pairs with levels
- FDA PGx biomarkers
### Drug Interactions
- Mechanism-based interactions (enzyme inhibition/induction)
- Key interactions from DailyMed
### Evidence Summary
| Finding | Source | Tier |
|---------|--------|------|
| Primary MOA | ChEMBL + DailyMed | T1/T2 |
| Off-targets | ChEMBL bioactivity | T2 |
| Pathways | KEGG/Reactome | T3 |
| PGx | CPIC/FDA | T1 |for drug in [("metformin", "CHEMBL1431"), ("pioglitazone", "CHEMBL595")]:
moa = tu.tools.OpenTargets_get_drug_mechanisms_of_action_by_chemblId(chemblId=drug[1])
clin = tu.tools.DailyMed_parse_clinical_pharmacology(drug_name=drug[0])| Step | Primary Tool | Fallback |
|---|---|---|
| Drug ID | OpenTargets_get_drug_id_description_by_name | PharmGKB_search_drugs |
| MOA | OpenTargets_get_drug_mechanisms_of_action_by_chemblId | ChEMBL_get_drug_mechanisms |
| Pathways | KEGG_get_gene_pathways | WikiPathways_find_pathways_by_gene, Reactome_map_uniprot_to_pathways |
| PGx | CPIC_search_gene_drug_pairs | fda_pharmacogenomic_biomarkers |
| Clinical info | DailyMed_parse_clinical_pharmacology | OpenTargets_get_drug_description_by_chemblId |
| DDI | DailyMed_parse_drug_interactions | PubMed_search_articles (DDI query) |
| Literature | PubMed_search_articles | EuropePMC_search_articles |