705 lines
30 KiB
Markdown
705 lines
30 KiB
Markdown
---
|
|
title: "Target Intelligence Tool Reference"
|
|
task: ""
|
|
lineage_type: import
|
|
upstream_source: https://github.com/mims-harvard/ToolUniverse/blob/e2520a96/skills/tooluniverse-target-research/REFERENCE.md
|
|
upstream_sha: e2520a96
|
|
imported_at: 2026-06-26
|
|
prompt_class: prompt
|
|
upstream_changes: accepted
|
|
author: upstream
|
|
validated: false
|
|
---
|
|
|
|
# Target Intelligence Tool Reference
|
|
|
|
Complete reference of 225+ ToolUniverse tools for target research, organized by category.
|
|
|
|
## 1. Core Protein Information (UniProt)
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `UniProt_get_entry_by_accession` | `accession` | Complete protein entry |
|
|
| `UniProt_get_function_by_accession` | `accession` | Functional annotations |
|
|
| `UniProt_get_recommended_name_by_accession` | `accession` | Official protein name |
|
|
| `UniProt_get_alternative_names_by_accession` | `accession` | Aliases and synonyms |
|
|
| `UniProt_get_organism_by_accession` | `accession` | Species info |
|
|
| `UniProt_get_subcellular_location_by_accession` | `accession` | Cellular localization |
|
|
| `UniProt_get_disease_variants_by_accession` | `accession` | Disease variants |
|
|
| `UniProt_get_ptm_processing_by_accession` | `accession` | PTMs, active sites |
|
|
| `UniProt_get_sequence_by_accession` | `accession` | Amino acid sequence |
|
|
| `UniProt_get_isoform_ids_by_accession` | `accession` | Splice isoforms |
|
|
| `UniProt_search` | `query`, `organism`, `limit`, `fields` | Search results |
|
|
| `UniProt_id_mapping` | `ids`, `from_db`, `to_db` | ID mappings |
|
|
| `UniProt_get_proteome` | `proteome_id` | Proteome info |
|
|
| `UniProt_get_uniref_cluster` | `cluster_id` | UniRef cluster |
|
|
| `UniProt_search_uniref` | `query`, `cluster_type`, `limit` | UniRef search |
|
|
| `UniProt_get_uniparc_entry` | `upi` | UniParc entry |
|
|
| `UniProt_search_uniparc` | `query`, `limit` | UniParc search |
|
|
|
|
### EBI Proteins API
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `proteins_api_get_protein` | `accession`, `format` | Comprehensive protein info |
|
|
| `proteins_api_get_features` | `accession` | Protein features |
|
|
| `proteins_api_get_variants` | `accession` | Protein variants |
|
|
| `proteins_api_get_comments` | `accession` | Annotations/comments |
|
|
| `proteins_api_get_epitopes` | `accession` | Epitope data |
|
|
| `proteins_api_get_proteomics` | `accession` | Proteomics data |
|
|
| `proteins_api_get_xrefs` | `accession` | Cross-references |
|
|
| `proteins_api_get_publications` | `accession` | Related publications |
|
|
| `proteins_api_get_genome_mappings` | `accession` | Genome mappings |
|
|
| `proteins_api_search` | `query` | Search proteins |
|
|
|
|
## 2. Gene Information
|
|
|
|
### MyGene (BioThings)
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `MyGene_get_gene_annotation` | `gene_id`, `fields` | Detailed gene annotation |
|
|
| `MyGene_query_genes` | `query`, `species`, `fields`, `size` | Gene search |
|
|
| `MyGene_batch_query` | `gene_ids`, `species`, `fields` | Batch gene query |
|
|
|
|
### Ensembl
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `ensembl_lookup_gene` | `gene_id`, `species` | Gene lookup |
|
|
| `ensembl_get_sequence` | `id`, `type`, `species` | DNA/protein sequence |
|
|
| `ensembl_get_variants` | `region`, `species` | Variants in region |
|
|
| `ensembl_get_variation` | `id`, `species` | Variation details |
|
|
| `ensembl_get_variation_phenotypes` | `id`, `species` | Phenotype associations |
|
|
| `ensembl_get_xrefs` | `id`, `external_db` | Cross-references |
|
|
| `ensembl_get_xrefs_by_name` | `name`, `species` | Xrefs by gene name |
|
|
| `ensembl_get_regulatory_features` | `region`, `species` | Regulatory features |
|
|
| `ensembl_get_genetree` | `id`, `prune_species` | Gene tree |
|
|
| `ensembl_get_homology` | `species`, `symbol`, `target_species` | Orthologs/paralogs |
|
|
| `ensembl_get_alignment` | `species`, `region` | Genomic alignments |
|
|
| `ensembl_get_taxonomy` | `id` | Taxonomy info |
|
|
| `ensembl_vep_region` | `species`, `region`, `allele` | Variant effect prediction |
|
|
|
|
### Other Gene Resources
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `kegg_get_gene_info` | `gene_id` | KEGG gene info |
|
|
| `kegg_find_genes` | `keyword`, `organism` | KEGG gene search |
|
|
| `cBioPortal_get_genes` | `keyword` | Cancer gene search |
|
|
| `civic_search_genes` | `gene_symbol` | CIViC gene info |
|
|
| `gnomad_get_gene` | `gene_symbol` | gnomAD gene data |
|
|
| `gnomad_search_variants` | `query` | gnomAD gene search |
|
|
| `gnomad_get_gene_constraints` | `gene_symbol` | Constraint scores |
|
|
|
|
## 3. Drug-Target Interactions
|
|
|
|
### DGIdb
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `DGIdb_get_drug_gene_interactions` | `genes`, `interaction_sources`, `interaction_types` | Drug-gene interactions |
|
|
| `DGIdb_get_gene_druggability` | `genes` | Druggability categories |
|
|
| `DGIdb_get_gene_info` | `genes` | Gene info from DGIdb |
|
|
| `DGIdb_get_drug_info` | `drugs` | Drug info from DGIdb |
|
|
|
|
### ChEMBL
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `ChEMBL_get_target` | `target_chembl_id`, `format` | Target details |
|
|
| `ChEMBL_search_targets` | `pref_name__contains`, `organism`, `target_type`, `limit` | Target search |
|
|
| `ChEMBL_get_target_activities` | `target_chembl_id__exact`, `limit` | Bioactivity data |
|
|
| `ChEMBL_get_target_assays` | `target_chembl_id__exact`, `limit` | Target assays |
|
|
| `ChEMBL_get_molecule_targets` | `molecule_chembl_id__exact`, `limit` | Molecule targets |
|
|
| `ChEMBL_search_binding_sites` | `target_chembl_id` | Binding sites |
|
|
| `ChEMBL_search_mechanisms` | `molecule_chembl_id`, `target_chembl_id` | Mechanisms of action |
|
|
| `ChEMBL_get_molecule` | `chembl_id`, `format` | Molecule details |
|
|
| `ChEMBL_search_molecules` | `pref_name__contains`, `limit` | Molecule search |
|
|
| `ChEMBL_get_assay` | `assay_chembl_id` | Assay details |
|
|
| `ChEMBL_search_activities` | `molecule_chembl_id`, `target_chembl_id`, `standard_type` | Activity search |
|
|
|
|
### DrugBank & GtoPdb
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `drugbank_get_targets_by_drug_name_or_drugbank_id` | `query`, `exact_match`, `limit` | Drug targets |
|
|
| `drugbank_get_drug_name_and_description_by_target_name` | `target_name` | Drugs for target |
|
|
| `GtoPdb_search_targets` | `target_id` | GtoPdb target info |
|
|
| `GtoPdb_search_targets` | `family_id` | List targets |
|
|
| `GtoPdb_search_ligands` | `target_id` | Target-ligand interactions |
|
|
| `GtoPdb_get_interactions` | `query` | Interaction search |
|
|
|
|
### STITCH
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `STITCH_get_chemical_protein_interactions` | `identifiers`, `species`, `required_score`, `limit` | Chemical-protein links |
|
|
| `STITCH_get_interaction_partners` | `identifiers`, `species` | Interaction network |
|
|
| `STITCH_resolve_identifier` | `identifier`, `species` | ID resolution |
|
|
|
|
### GPCRdb (NEW - for GPCR Targets)
|
|
|
|
~35% of approved drugs target GPCRs. GPCRdb provides specialized data for G protein-coupled receptors.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `GPCRdb_get_protein` | `operation="get_protein"`, `protein` (entry name) | GPCR family, class, sequence info |
|
|
| `GPCRdb_list_proteins` | `operation="list_proteins"`, `family` (optional) | List GPCR families/proteins |
|
|
| `GPCRdb_get_structures` | `operation="get_structures"`, `protein`, `state` (optional) | Structures with receptor state (active/inactive) |
|
|
| `GPCRdb_get_ligands` | `operation="get_ligands"`, `protein` | Known ligands (agonists/antagonists) |
|
|
| `GPCRdb_get_mutations` | `operation="get_mutations"`, `protein` | Mutation effects on binding/signaling |
|
|
|
|
**Entry name format**: `{gene_lower}_human` (e.g., `adrb2_human`, `drd2_human`)
|
|
|
|
**Key advantages**:
|
|
- Active vs. inactive state structures
|
|
- Ballesteros-Weinstein residue numbering
|
|
- Curated ligand binding data
|
|
- Experimental mutation effects
|
|
|
|
### Pharos/TCRD (NEW - Target Development Level)
|
|
|
|
NIH's Illuminating the Druggable Genome (IDG) portal provides TDL classification.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `Pharos_get_target` | `gene` OR `uniprot` | TDL, family, novelty, description |
|
|
| `Pharos_search_targets` | `query`, `top` | Target list with TDL |
|
|
| `Pharos_get_tdl_summary` | - | TDL level descriptions |
|
|
| `Pharos_get_disease_targets` | `disease`, `top` | Targets for disease with TDL |
|
|
|
|
**TDL Classification**:
|
|
| Level | Description | Druggability |
|
|
|-------|-------------|--------------|
|
|
| **Tclin** | Approved drug targets | Highest |
|
|
| **Tchem** | Small molecule activities (IC50 < 30nM) | Good |
|
|
| **Tbio** | Biological annotations only | Moderate |
|
|
| **Tdark** | Understudied proteins | Unknown |
|
|
|
|
**Example**:
|
|
```python
|
|
result = tu.tools.Pharos_get_target(gene="EGFR")
|
|
# Returns: tdl="Tclin", fam="Kinase", novelty=0.2, publicationCount=45000
|
|
```
|
|
|
|
### DepMap (NEW - Target Essentiality)
|
|
|
|
CRISPR knockout essentiality data from cancer cell lines.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `DepMap_get_gene_dependencies` | `gene_symbol` | Gene essentiality data |
|
|
| `DepMap_get_cell_lines` | `tissue`, `cancer_type`, `page_size` | Cell line metadata |
|
|
| `DepMap_search_cell_lines` | `query` | Search cell lines |
|
|
| `DepMap_get_cell_line` | `model_id` OR `model_name` | Detailed cell line info |
|
|
| Drug sensitivity (GDSC) | `drug` / `cell-line` / `target` | No TU tool — run the precision-oncology skill's `scripts/gdsc_drug_response.py` (GDSC bulk data, IC50/AUC) |
|
|
|
|
**Effect Score Interpretation**:
|
|
| Score | Meaning |
|
|
|-------|---------|
|
|
| < -1.0 | Strongly essential |
|
|
| -0.5 to -1.0 | Essential |
|
|
| -0.5 to 0 | Weakly essential |
|
|
| > 0 | Not essential |
|
|
|
|
**Example**:
|
|
```python
|
|
deps = tu.tools.DepMap_get_gene_dependencies(gene_symbol="KRAS")
|
|
# Returns: Gene info, note about essentiality
|
|
|
|
cells = tu.tools.DepMap_get_cell_lines(cancer_type="Lung Cancer", page_size=10)
|
|
# Returns: Cell line names, cancer types, MSI status
|
|
```
|
|
|
|
### InterProScan (NEW - Domain Prediction)
|
|
|
|
De novo domain/family prediction for novel sequences.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `InterProScan_scan_sequence` | `sequence`, `go_terms`, `pathways` | Domains, GO terms, pathways |
|
|
| `InterProScan_get_job_status` | `job_id` | Job status |
|
|
| `InterProScan_get_job_results` | `job_id` | Completed results |
|
|
|
|
**When to use**: Novel proteins, Tdark targets, custom sequences.
|
|
|
|
**Example**:
|
|
```python
|
|
# Submit sequence for analysis
|
|
result = tu.tools.InterProScan_scan_sequence(
|
|
sequence="MVLSPADKTNVKAAWGKVGAHAGEYGAEALERMFLSFPTTKTYFPHFDLSH...",
|
|
go_terms=True,
|
|
pathways=True
|
|
)
|
|
# Returns: job_id (if running) or domains/GO/pathways (if complete)
|
|
|
|
# Check job if still running
|
|
status = tu.tools.InterProScan_get_job_status(job_id="iprscan5-xxx")
|
|
results = tu.tools.InterProScan_get_job_results(job_id="iprscan5-xxx")
|
|
```
|
|
|
|
### BindingDB (NEW - Ligand Binding Data)
|
|
|
|
Experimental binding affinity data (Ki, IC50, Kd) for target-ligand pairs.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `BindingDB_get_ligands_by_uniprot` | `uniprot`, `affinity_cutoff` | Ligands with affinities |
|
|
| `BindingDB_get_ligands_by_uniprots` | `uniprots`, `affinity_cutoff` | Multi-target ligands |
|
|
| `BindingDB_get_ligands_by_pdb` | `pdb_ids`, `affinity_cutoff`, `sequence_identity` | Structure-based ligands |
|
|
| `BindingDB_get_targets_by_compound` | `smiles`, `similarity_cutoff` | Polypharmacology |
|
|
|
|
**Example**:
|
|
```python
|
|
# Get ligands for EGFR
|
|
ligands = tu.tools.BindingDB_get_ligands_by_uniprot(
|
|
uniprot="P00533",
|
|
affinity_cutoff=100 # Only potent ligands <100 nM
|
|
)
|
|
# Returns: SMILES, affinity_type (Ki/IC50/Kd), affinity value, PMID
|
|
|
|
# Find targets for a compound
|
|
targets = tu.tools.BindingDB_get_targets_by_compound(
|
|
smiles="CC(=O)Nc1ccc(cc1)O",
|
|
similarity_cutoff=0.85
|
|
)
|
|
# Returns: proteins with similar compound activities
|
|
```
|
|
|
|
**Affinity Interpretation**:
|
|
| Range | Level | Drug Potential |
|
|
|-------|-------|----------------|
|
|
| <1 nM | Ultra-potent | Clinical candidate |
|
|
| 1-30 nM | Tchem threshold | Drug-like |
|
|
| 30-100 nM | Potent | Good start |
|
|
| 100-1000 nM | Moderate | Needs optimization |
|
|
|
|
### Human Protein Atlas (NEW - Expression)
|
|
|
|
Protein and RNA expression across tissues and cell lines.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `HPA_search_genes_by_query` | `search_query` | Gene info, Ensembl ID |
|
|
| `HPA_generic_search` | `search_query`, `columns` | Custom data fields |
|
|
| `HPA_get_comparative_expression_by_gene_and_cellline` | `gene_name`, `cell_line` | Cancer vs normal |
|
|
|
|
**Example**:
|
|
```python
|
|
# Search gene
|
|
gene = tu.tools.HPA_search_genes_by_query(search_query="EGFR")
|
|
# Returns: Gene name, Ensembl ID, synonyms
|
|
|
|
# Compare cancer cell line vs normal tissue
|
|
expr = tu.tools.HPA_get_comparative_expression_by_gene_and_cellline(
|
|
gene_name="EGFR",
|
|
cell_line="a549" # Lung cancer
|
|
)
|
|
# Returns: expression comparison
|
|
```
|
|
|
|
**Supported Cell Lines**: a549, mcf7, hela, hepg2, pc3, jurkat, rh30, siha, u251, ishikawa
|
|
|
|
### PubChem BioAssay (NEW - Screening Data)
|
|
|
|
HTS screening data and dose-response curves.
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `PubChem_search_assays_by_target_gene` | `gene_symbol` | AIDs for gene |
|
|
| `PubChem_get_assay_summary` | `aid` | Assay statistics |
|
|
| `PubChem_get_assay_targets` | `aid` | Target info |
|
|
| `PubChem_get_assay_active_compounds` | `aid` | Active CIDs |
|
|
| `PubChem_get_assay_dose_response` | `aid` | IC50/EC50 data |
|
|
|
|
**Example**:
|
|
```python
|
|
# Find assays for target
|
|
assays = tu.tools.PubChem_search_assays_by_target_gene(gene_symbol="EGFR")
|
|
# Returns: list of AIDs
|
|
|
|
# Get assay summary
|
|
summary = tu.tools.PubChem_get_assay_summary(aid=504526)
|
|
# Returns: active/inactive counts, target info
|
|
|
|
# Get active compounds
|
|
actives = tu.tools.PubChem_get_assay_active_compounds(aid=504526)
|
|
# Returns: CIDs of active compounds
|
|
```
|
|
|
|
## 4. Open Targets Platform
|
|
|
|
### Target-Centric
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `OpenTargets_get_target_id_description_by_name` | `targetName` | Target ID lookup |
|
|
| `OpenTargets_get_associated_drugs_by_target_ensemblID` | `ensemblID` | Drugs for target |
|
|
| `OpenTargets_get_diseases_phenotypes_by_target_ensembl` | `ensemblID` | Diseases for target |
|
|
| `OpenTargets_get_target_safety_profile_by_ensemblID` | `ensemblID` | Safety info |
|
|
| `OpenTargets_get_target_tractability_by_ensemblID` | `ensemblID` | Tractability |
|
|
| `OpenTargets_get_target_interactions_by_ensemblID` | `ensemblID` | PPI via Open Targets |
|
|
| `OpenTargets_get_target_gene_ontology_by_ensemblID` | `ensemblID` | GO terms |
|
|
| `OpenTargets_get_target_synonyms_by_ensemblID` | `ensemblID` | Target synonyms |
|
|
| `OpenTargets_get_target_classes_by_ensemblID` | `ensemblID` | Classifications |
|
|
| `OpenTargets_get_target_constraint_info_by_ensemblID` | `ensemblID` | Constraint data |
|
|
| `OpenTargets_get_target_genomic_location_by_ensemblID` | `ensemblID` | Genomic location |
|
|
| `OpenTargets_get_target_subcell_locations_by_ensembl_ID` | `ensemblID` | Subcellular location |
|
|
| `OpenTargets_get_target_homologues_by_ensemblID` | `ensemblID` | Homologs |
|
|
| `OpenTargets_get_target_enabling_packages_by_ensemblID` | `ensemblID` | TEP info |
|
|
| `OpenTargets_get_chemical_probes_by_target_ensemblID` | `ensemblID` | Chemical probes |
|
|
| `OpenTargets_get_biological_mouse_models_by_ensemblID` | `ensemblID` | Mouse models |
|
|
| `OpenTargets_get_publications_by_target_ensemblID` | `ensemblID` | Publications |
|
|
| `OpenTargets_get_similar_entities_by_target_ensemblID` | `ensemblID` | Similar targets |
|
|
|
|
### Disease-Target Evidence
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `OpenTargets_get_associated_targets_by_disease_efoId` | `efoId` | Targets for disease |
|
|
| `OpenTargets_target_disease_evidence` | `ensemblID`, `efoId` | Evidence details |
|
|
| `disease_target_score` | `efoId`, `datasourceId` | Disease-target scores |
|
|
|
|
## 5. Protein Structure
|
|
|
|
### RCSB PDB
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `get_protein_metadata_by_pdb_id` | `pdb_id` | Basic metadata |
|
|
| `get_protein_classification_by_pdb_id` | `pdb_id` | Protein classification |
|
|
| `get_sequence_by_pdb_id` | `pdb_id` | PDB sequence |
|
|
| `get_binding_affinity_by_pdb_id` | `pdb_id` | Binding affinity data |
|
|
| `get_target_cofactor_info` | `pdb_id` | Cofactor info |
|
|
| `get_polymer_entity_annotations` | `entity_id` | Polymer annotations |
|
|
| `get_uniprot_accession_by_entity_id` | `entity_id` | UniProt from PDB |
|
|
| `get_gene_name_by_entity_id` | `entity_id` | Gene name from PDB |
|
|
| `PDB_search_similar_structures` | `pdb_id` | Similar structures |
|
|
| `get_polymer_entity_ids_by_pdb_id` | `pdb_id` | Polymer entity IDs |
|
|
| `get_source_organism_by_pdb_id` | `pdb_id` | Source organism |
|
|
| `get_citation_info_by_pdb_id` | `pdb_id` | Citation info |
|
|
| `get_mutation_annotations_by_pdb_id` | `pdb_id` | Mutation annotations |
|
|
| `get_assembly_info_by_pdb_id` | `pdb_id` | Biological assembly |
|
|
| `get_taxonomy_by_pdb_id` | `pdb_id` | Taxonomy |
|
|
| `get_crystallographic_properties_by_pdb_id` | `pdb_id` | Crystal properties |
|
|
| `get_structure_validation_metrics_by_pdb_id` | `pdb_id` | Validation metrics |
|
|
| `get_ligand_smiles_by_chem_comp_id` | `chem_comp_id` | Ligand SMILES |
|
|
| `visualize_protein_structure_3d` | `pdb_id` | 3D visualization |
|
|
|
|
### PDBe
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `pdbe_get_entry_summary` | `pdb_id` | Entry summary |
|
|
| `pdbe_get_entry_quality` | `pdb_id` | Quality metrics |
|
|
| `pdbe_get_entry_publications` | `pdb_id` | Publications |
|
|
| `pdbe_get_entry_assemblies` | `pdb_id` | Biological assemblies |
|
|
| `pdbe_get_entry_secondary_structure` | `pdb_id` | Secondary structure |
|
|
| `pdbe_get_entry_molecules` | `pdb_id` | Molecule info |
|
|
| `pdbe_get_entry_status` | `pdb_id` | Entry status |
|
|
| `pdbe_get_entry_experiment` | `pdb_id` | Experimental details |
|
|
|
|
### AlphaFold
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `alphafold_get_prediction` | `qualifier` (UniProt) | Full 3D predictions |
|
|
| `alphafold_get_summary` | `qualifier` | Summary/metadata |
|
|
| `alphafold_get_annotations` | `qualifier` | Annotations |
|
|
|
|
### EMDB
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `EMDB_search_structures` | `query` | EM structure search |
|
|
| `EMDB_get_structure` | `emdb_id` | EM structure details |
|
|
|
|
## 6. Protein-Protein Interactions
|
|
|
|
### STRING
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `STRING_get_protein_interactions` | `protein_ids`, `species`, `confidence_score`, `network_type`, `limit` | PPI network |
|
|
|
|
### IntAct
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `intact_get_interactions` | `identifier`, `format` | Interactions |
|
|
| `intact_search_interactions` | `query`, `first`, `max` | Interaction search |
|
|
| `intact_get_interactor` | `identifier`, `format` | Interactor details |
|
|
| `intact_get_interaction_network` | `identifier`, `depth` | Interaction network |
|
|
| `intact_get_interaction_details` | `interaction_id` | Interaction details |
|
|
| `intact_get_interactions_by_organism` | `taxid`, `size` | Organism interactions |
|
|
| `intact_get_interactions_by_complex` | `complex_id` | Complex interactions |
|
|
| `intact_get_complex_details` | `complex_ac` | Complex details |
|
|
|
|
### Other PPI Sources
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `BioGRID_get_interactions` | `gene_names`, `organism`, `interaction_type`, `limit` | BioGRID PPI |
|
|
| `HPA_get_protein_interactions_by_gene` | `gene_symbol` | HPA interactions |
|
|
| `humanbase_ppi_analysis` | `genes`, `tissue` | HumanBase PPI |
|
|
| `Reactome_get_interactor` | `id` | Reactome interactors |
|
|
| `pc_get_interactions` | `source`, `target` | Pathway Commons |
|
|
|
|
## 7. Functional Annotations
|
|
|
|
### Gene Ontology
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `GO_get_annotations_for_gene` | `gene_id` | GO annotations |
|
|
| `GO_get_genes_for_term` | `go_id`, `taxon`, `rows` | Genes for GO term |
|
|
| `GO_search_terms` | `query` | GO term search |
|
|
| `GO_get_term_details` | `id` | GO term details |
|
|
| `GO_get_term_by_id` | `id` | GO term info |
|
|
| `OpenTargets_get_gene_ontology_terms_by_goID` | `goId` | GO term via OT |
|
|
|
|
### InterPro & Pfam
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `InterPro_get_protein_domains` | `protein_id` | Domain annotations |
|
|
| `InterPro_search_domains` | `query`, `page_size` | Domain search |
|
|
| `InterPro_get_domain_details` | `accession` | Domain details |
|
|
|
|
### Gene Set Enrichment
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `enrichr_gene_enrichment_analysis` | `genes`, `gene_set_library` | Enrichment analysis |
|
|
|
|
## 8. Pathways
|
|
|
|
### Reactome
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `Reactome_map_uniprot_to_pathways` | `id` (UniProt) | Pathways for protein |
|
|
| `Reactome_map_uniprot_to_reactions` | `id` | Reactions for protein |
|
|
| `Reactome_get_pathway` | `stId` | Pathway details |
|
|
| `Reactome_get_pathway_reactions` | `stId` | Pathway reactions |
|
|
| `Reactome_get_pathway_hierarchy` | `stId` | Parent pathways |
|
|
| `Reactome_list_top_pathways` | `species` | Top-level pathways |
|
|
| `Reactome_get_participants` | `stId` | Reaction participants |
|
|
| `Reactome_get_reaction` | `stId` | Reaction details |
|
|
| `Reactome_get_complex` | `stId` | Complex details |
|
|
| `Reactome_list_species` | - | All species |
|
|
| `Reactome_query_by_ids` | `ids`, `species` | ID query |
|
|
| `Reactome_get_events_hierarchy` | `species` | Full hierarchy |
|
|
| `Reactome_get_diseases` | - | Disease pathways |
|
|
|
|
### KEGG
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `kegg_get_pathway_info` | `pathway_id` | Pathway details |
|
|
| `kegg_search_pathway` | `keyword`, `org` | Pathway search |
|
|
| `kegg_list_organisms` | - | All organisms |
|
|
|
|
### WikiPathways
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `WikiPathways_get_pathway` | `wpid`, `format` | Pathway content |
|
|
| `WikiPathways_search` | `query`, `organism` | Pathway search |
|
|
|
|
### Pathway Commons
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `pc_search_pathways` | `query` | Pathway search |
|
|
|
|
## 9. Gene Expression
|
|
|
|
### GTEx
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `GTEx_get_gene_expression` | `gencode_id`, `tissue_site_detail_id` | Expression data |
|
|
| `GTEx_get_median_gene_expression` | `gencode_id` | Median by tissue |
|
|
| `GTEx_get_top_expressed_genes` | `tissue_id` | Top genes in tissue |
|
|
| `GTEx_get_expression_summary` | `gencode_id` | Expression summary |
|
|
| `GTEx_get_eqtl_genes` | `tissue_id` | eQTL genes |
|
|
| `GTEx_get_single_tissue_eqtls` | `gencode_id`, `tissue_id` | Single tissue eQTL |
|
|
| `GTEx_get_multi_tissue_eqtls` | `gencode_id` | Multi-tissue eQTL |
|
|
| `GTEx_calculate_eqtl` | `gencode_id`, `variant_id` | Calculate eQTL |
|
|
|
|
### Human Protein Atlas (HPA)
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `HPA_search_genes_by_query` | `search_query` | Gene search |
|
|
| `HPA_get_gene_basic_info_by_ensembl_id` | `ensembl_id` | Basic gene info |
|
|
| `HPA_get_comprehensive_gene_details_by_ensembl_id` | `ensembl_id` | Comprehensive details |
|
|
| `HPA_get_rna_expression_in_specific_tissues` | `ensembl_id`, `tissue` | Tissue RNA expression |
|
|
| `HPA_get_rna_expression_by_source` | `ensembl_id` | Expression by source |
|
|
| `HPA_get_subcellular_location` | `ensembl_id` | Subcellular location |
|
|
| `HPA_get_disease_expression_by_gene_tissue_disease` | `ensembl_id`, `tissue`, `disease` | Disease expression |
|
|
| `HPA_get_cancer_prognostics_by_gene` | `gene_symbol` | Cancer prognostics |
|
|
| `HPA_get_biological_processes_by_gene` | `gene_symbol` | Biological processes |
|
|
|
|
### Single-Cell
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `CELLxGENE_get_expression_data` | `gene_id`, `dataset_id` | Single-cell expression |
|
|
| `CELLxGENE_get_gene_metadata` | `gene_id` | Gene metadata |
|
|
|
|
## 10. Variants & Mutations
|
|
|
|
### ClinVar
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `ClinVar_search_variants` | `gene`, `condition`, `variant_id`, `max_results` | Variant search |
|
|
| `ClinVar_get_variant_details` | `variant_id` | Variant details |
|
|
| `ClinVar_get_clinical_significance` | `variant_id` | Clinical significance |
|
|
|
|
### dbSNP
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `dbsnp_get_variant_by_rsid` | `rsid` | dbSNP variant |
|
|
| `dbsnp_search_by_gene` | `gene_symbol` | dbSNP by gene |
|
|
| `dbsnp_get_frequencies` | `rsid` | Allele frequencies |
|
|
|
|
### gnomAD
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `gnomad_get_variant` | `variant_id` | gnomAD variant |
|
|
| `gnomad_search_variants` | `query` | Variant search |
|
|
| `gnomad_get_region` | `chrom`, `start`, `stop` | Variants in region |
|
|
|
|
### CIViC
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `civic_get_variant` | `variant_id` | CIViC variant |
|
|
| `civic_get_variants_by_gene` | `gene_symbol` | Variants for gene |
|
|
| `civic_search_variants` | `query` | Variant search |
|
|
|
|
### Other Variant Sources
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `MyVariant_get_variant_annotation` | `variant_id` | MyVariant annotation |
|
|
| `MyVariant_query_variants` | `query` | Variant query |
|
|
| `PharmGKB_search_variants` | `query` | PharmGKB variants |
|
|
| `cBioPortal_get_mutations` | `gene_symbol`, `study_id` | Cancer mutations |
|
|
| `RegulomeDB_query_variant` | `variant_id` | Regulatory annotation |
|
|
| `gwas_search_snps` | `query` | GWAS SNPs |
|
|
| `gwas_get_snp_by_id` | `snp_id` | GWAS SNP details |
|
|
| `gwas_get_snps_for_gene` | `gene_symbol` | GWAS SNPs for gene |
|
|
|
|
## 11. Literature
|
|
|
|
### PubMed
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `PubMed_search_articles` | `query`, `limit`, `api_key` | Article search |
|
|
| `PubMed_get_article` | `pmid`, `api_key` | Article metadata |
|
|
| `PubMed_get_related` | `pmid`, `limit` | Related articles |
|
|
| `PubMed_get_cited_by` | `pmid`, `limit` | Citing articles |
|
|
| `PubMed_get_links` | `pmid` | External links |
|
|
|
|
### Europe PMC
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `EuropePMC_search_articles` | `query`, `limit` | Article search |
|
|
| `EuropePMC_get_citations` | `source`, `article_id` | Citations |
|
|
| `EuropePMC_get_references` | `source`, `article_id` | References |
|
|
|
|
### Other Literature
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `PMC_search_papers` | `query` | PMC full-text search |
|
|
| `PubTator3_LiteratureSearch` | `query` | PubTator with NER |
|
|
| `PubTator3_EntityAutocomplete` | `query` | Entity autocomplete |
|
|
| `openalex_search_works` | `query` | OpenAlex publications |
|
|
| `openalex_literature_search` | `query` | Literature search |
|
|
|
|
## 12. Pharmacogenomics
|
|
|
|
### PharmGKB
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `PharmGKB_get_gene_details` | `gene_symbol` | Gene info |
|
|
| `PharmGKB_search_genes` | `query` | Gene search |
|
|
| `PharmGKB_get_drug_details` | `drug_name` | Drug details |
|
|
| `PharmGKB_search_drugs` | `query` | Drug search |
|
|
| `PharmGKB_get_clinical_annotations` | `gene_symbol` | Clinical annotations |
|
|
| `PharmGKB_get_dosing_guidelines` | `gene_symbol` | Dosing guidelines |
|
|
| `OpenTargets_drug_pharmacogenomics_data` | `chemblId` | OT pharmacogenomics |
|
|
| `fda_pharmacogenomic_biomarkers` | - | FDA biomarkers |
|
|
|
|
## 13. Disease Associations
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `OpenTargets_get_disease_ids_by_name` | `diseaseName` | Disease ID lookup |
|
|
| `OpenTargets_get_disease_description_by_efoId` | `efoId` | Disease description |
|
|
| `OpenTargets_get_associated_drugs_by_disease_efoId` | `efoId` | Drugs for disease |
|
|
| `OpenTargets_get_publications_by_disease_efoId` | `efoId` | Disease publications |
|
|
| `OpenTargets_get_disease_therapeutic_areas_by_efoId` | `efoId` | Therapeutic areas |
|
|
| `gwas_search_studies` | `query` | GWAS studies |
|
|
| `gwas_get_studies_for_trait` | `trait` | Studies for trait |
|
|
| `gwas_search_associations` | `query` | GWAS associations |
|
|
| `gwas_get_associations_for_trait` | `trait` | Associations for trait |
|
|
| `GtoPdb_search_diseases` | - | GtoPdb diseases |
|
|
| `GtoPdb_search_diseases` | `disease_id` | Disease details |
|
|
| `Reactome_get_diseases` | - | Reactome diseases |
|
|
| `OSL_get_efo_id_by_disease_name` | `disease_name` | EFO ID lookup |
|
|
|
|
### DisGeNET (NEW - Gene-Disease Associations)
|
|
|
|
DisGeNET integrates gene-disease associations from curated repositories, GWAS catalogs, animal models, and literature. **Requires**: `DISGENET_API_KEY`
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `DisGeNET_search_gene` | `operation="search_gene"`, `gene` (symbol/ID), `limit` | Diseases associated with gene |
|
|
| `DisGeNET_search_disease` | `operation="search_disease"`, `disease` (name/UMLS CUI), `limit` | Genes associated with disease |
|
|
| `DisGeNET_get_gda` | `operation="get_gda"`, `gene`, `disease`, `min_score` | Gene-disease association details |
|
|
| `DisGeNET_get_vda` | `operation="get_vda"`, `variant` (rsID), `limit` | Variant-disease associations |
|
|
| `DisGeNET_get_disease_genes` | `operation="get_disease_genes"`, `disease`, `limit` | All genes for a disease |
|
|
|
|
**Key metrics**:
|
|
- **GDA Score**: 0-1 confidence score for gene-disease association
|
|
- **Evidence Index**: Number and diversity of sources
|
|
- **Disease Specificity Index**: How specific is gene to this disease
|
|
- **Disease Pleiotropy Index**: How many diseases gene is linked to
|
|
|
|
**Interpretation**:
|
|
- Score ≥0.7: Strong association (consider T2 evidence)
|
|
- Score 0.4-0.7: Moderate association
|
|
- Score <0.4: Weak/limited evidence
|
|
|
|
## 14. ID Conversion & Cross-References
|
|
|
|
| Tool | Parameters | Returns |
|
|
|------|------------|---------|
|
|
| `UniProt_id_mapping` | `ids`, `from_db`, `to_db` | ID conversion |
|
|
| `OpenTargets_map_any_disease_id_to_all_other_ids` | `diseaseId` | Disease ID mapping |
|
|
| `ebi_cross_reference_search` | `identifier`, `source` | EBI cross-refs |
|
|
| `Reactome_query_by_ids` | `ids` | Reactome ID lookup |
|
|
|
|
## Common ID Mapping Combinations
|
|
|
|
| From | To | Tool Call |
|
|
|------|----|----|
|
|
| Gene Symbol → UniProt | `UniProt_search(query='gene:EGFR AND organism_id:9606')` |
|
|
| UniProt → Ensembl | `UniProt_id_mapping(ids=['P00533'], from_db='UniProtKB_AC-ID', to_db='Ensembl')` |
|
|
| Ensembl → UniProt | `UniProt_id_mapping(ids=['ENSG00000146648'], from_db='Ensembl', to_db='UniProtKB')` |
|
|
| UniProt → PDB | Extract from UniProt entry cross-references |
|
|
| Gene Symbol → Entrez | `MyGene_query_genes(query='symbol:EGFR', species='human')` |
|
|
| UniProt → ChEMBL Target | `ChEMBL_search_targets(pref_name__contains='EGFR', organism='Homo sapiens')` |
|