Gtopdb Tools

Configuration File: gtopdb_tools.json Tool Type: Local Tools Count: 8

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

Available Tools

GtoPdb_get_disease (Type: GtoPdbRESTTool)

Get detailed information about a specific disease by its GtoPdb disease ID. Returns disease descr…

GtoPdb_get_disease tool specification

Tool Information:

• Name: GtoPdb_get_disease

• Type: GtoPdbRESTTool

• Description: Get detailed information about a specific disease by its GtoPdb disease ID. Returns disease description, associated pharmacological targets, therapeutic ligands (including approved drugs), and database cross-references. Use disease ID from GtoPdb_list_diseases. Essential for finding drug targets and treatments for specific conditions.

Parameters:

• disease_id (integer) (required) GtoPdb disease identifier. Find disease IDs using GtoPdb_list_diseases.

Example Usage:

query = {
    "name": "GtoPdb_get_disease",
    "arguments": {
        "disease_id": 10
    }
}
result = tu.run(query)

GtoPdb_get_ligand (Type: GtoPdbRESTTool)

Get detailed information about a specific ligand by its GtoPdb ligand ID. Returns comprehensive d…

GtoPdb_get_ligand tool specification

Tool Information:

• Name: GtoPdb_get_ligand

• Type: GtoPdbRESTTool

• Description: Get detailed information about a specific ligand by its GtoPdb ligand ID. Returns comprehensive data including chemical structure (SMILES, InChI), molecular properties, clinical data, associated targets with affinity values, database cross-references, and synonyms. Use ligand ID from GtoPdb_list_ligands or search results.

Parameters:

• ligand_id (integer) (required) GtoPdb ligand identifier (e.g., 1016 for tamoxifen). Find ligand IDs using GtoPdb_list_ligands.

Example Usage:

query = {
    "name": "GtoPdb_get_ligand",
    "arguments": {
        "ligand_id": 10
    }
}
result = tu.run(query)

GtoPdb_get_target (Type: GtoPdbRESTTool)

Get detailed information about a specific pharmacological target by its GtoPdb target ID. Returns…

GtoPdb_get_target tool specification

Tool Information:

• Name: GtoPdb_get_target

• Type: GtoPdbRESTTool

• Description: Get detailed information about a specific pharmacological target by its GtoPdb target ID. Returns comprehensive target data including gene information, protein structure, tissue distribution, associated ligands and drugs, pathophysiology, mutations, and database cross-references. Use the target ID from GtoPdb_get_targets or search results.

Parameters:

• target_id (integer) (required) GtoPdb target identifier (e.g., 290 for adenosine A1 receptor). Find target IDs using GtoPdb_get_targets.

Example Usage:

query = {
    "name": "GtoPdb_get_target",
    "arguments": {
        "target_id": 10
    }
}
result = tu.run(query)

GtoPdb_get_target_interactions (Type: GtoPdbRESTTool)

Get all ligand interactions for a specific target by its GtoPdb target ID. Returns detailed inter…

GtoPdb_get_target_interactions tool specification

Tool Information:

• Name: GtoPdb_get_target_interactions

• Type: GtoPdbRESTTool

• Description: Get all ligand interactions for a specific target by its GtoPdb target ID. Returns detailed interaction data including affinity measurements, action types, endogenous ligands, and rank-order potency. Use this to find all known ligands for a target, compare binding affinities, or identify the most potent agonists/antagonists. Get target IDs using GtoPdb_get_targets first.

Parameters:

• target_id (integer) (required) GtoPdb target identifier (e.g., 221 for GPER). Find target IDs using GtoPdb_get_targets.

• action_type (string) (optional) Filter by action: ‘Agonist’, ‘Antagonist’, ‘Inhibitor’, ‘Activator’, ‘Channel blocker’, etc. Leave empty for all.

• affinity_parameter (string) (optional) Affinity type: ‘pKi’, ‘pIC50’, ‘pEC50’, ‘pKd’. Leave empty for all affinity measurements.

• min_affinity (number) (optional) Minimum affinity value (e.g., 7.0). Leave empty for all affinities. Note: This parameter may not be supported by the API - consider filtering results after retrieval instead.

Example Usage:

query = {
    "name": "GtoPdb_get_target_interactions",
    "arguments": {
        "target_id": 10
    }
}
result = tu.run(query)

GtoPdb_get_targets (Type: GtoPdbRESTTool)

Search the IUPHAR/BPS Guide to Pharmacology (GtoPdb) for pharmacological targets including protei…

GtoPdb_get_targets tool specification

Tool Information:

• Name: GtoPdb_get_targets

• Type: GtoPdbRESTTool

• Description: Search the IUPHAR/BPS Guide to Pharmacology (GtoPdb) for pharmacological targets including proteins, receptors, enzymes, and ion channels. Returns target details with associated ligands, approved drugs, mechanisms of action, and cross-references to UniProt, Ensembl, and HGNC. Use this for drug discovery, target validation, drug-receptor interaction studies, and finding drug repurposing opportunities.

Parameters:

• target_type (string) (optional) Type of pharmacological target. Options: ‘GPCR’ (G-protein coupled receptor), ‘Enzyme’, ‘LGIC’ (ligand-gated ion channel), ‘VGIC’ (voltage-gated ion channel), ‘NHR’ (nuclear hormone receptor), ‘Catalytic receptor’, ‘Transporter’, ‘Other protein’, ‘Other ion channel’. Leave empty to get all targets.

• limit (integer) (optional) Maximum number of targets to return (default: 20, max: 1000)

Example Usage:

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

GtoPdb_list_diseases (Type: GtoPdbRESTTool)

Search and list diseases from the Guide to Pharmacology with associated pharmacological targets a…

GtoPdb_list_diseases tool specification

Tool Information:

• Name: GtoPdb_list_diseases

• Type: GtoPdbRESTTool

• Description: Search and list diseases from the Guide to Pharmacology with associated pharmacological targets and ligands. Returns disease information with cross-references to OMIM, Disease Ontology, and Orphanet databases. Use this to identify disease-relevant targets, find therapeutic interventions, or explore pharmacology of specific conditions.

Parameters:

• name (string) (optional) Search diseases by name (partial match). Examples: ‘diabetes’, ‘cancer’, ‘asthma’, ‘Alzheimer’.

• limit (integer) (optional) Maximum number of diseases to return (default: 20, max: 1000).

Example Usage:

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

GtoPdb_list_ligands (Type: GtoPdbRESTTool)

Search and list ligands from the Guide to Pharmacology including synthetic drugs, natural product…

GtoPdb_list_ligands tool specification

Tool Information:

• Name: GtoPdb_list_ligands

• Type: GtoPdbRESTTool

• Description: Search and list ligands from the Guide to Pharmacology including synthetic drugs, natural products, metabolites, peptides, and antibodies. Returns ligand details with molecular properties (LogP, molecular weight, SMILES), biological activity, associated targets, and database cross-references (ChEMBL, PubChem, DrugBank). Filter by ligand type (Approved, Metabolite, Peptide), name, or molecular properties.

Parameters:

• ligand_type (string) (optional) Filter by ligand type. Options: ‘Approved’ (approved drugs), ‘Synthetic organic’, ‘Metabolite’, ‘Natural product’, ‘Endogenous peptide’, ‘Peptide’, ‘Antibody’, ‘Withdrawn’. Leave empty for all ligands.

• name (string) (optional) Search ligands by name (partial match). Example: ‘aspirin’, ‘caffeine’, ‘insulin’.

• limit (integer) (optional) Maximum number of ligands to return (default: 20, max: 1000).

Example Usage:

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

GtoPdb_search_interactions (Type: GtoPdbRESTTool)

Search pharmacological interactions between targets and ligands across the Guide to Pharmacology …

GtoPdb_search_interactions tool specification

Tool Information:

• Name: GtoPdb_search_interactions

• Type: GtoPdbRESTTool

• Description: Search pharmacological interactions between targets and ligands across the Guide to Pharmacology database. Returns interaction data with affinity measurements (pKi, pIC50, pEC50), action types (agonist, antagonist, inhibitor), species, and references. Filter by target type, ligand type, action type, affinity parameter, or approved drugs. Essential for finding drug-target pairs and structure-activity relationships. Note: Use parameters individually or in simple combinations - complex filter combinations may not be supported by the API.

Parameters:

• target_type (string) (optional) Filter by target class: ‘GPCR’, ‘NHR’, ‘LGIC’, ‘VGIC’, ‘Enzyme’, ‘Transporter’, etc.

• ligand_type (string) (optional) Filter by ligand class: ‘Synthetic organic’, ‘Metabolite’, ‘Peptide’, ‘Antibody’, etc.

• action_type (string) (optional) Filter by interaction type: ‘Agonist’, ‘Antagonist’, ‘Inhibitor’, ‘Activator’, ‘Channel blocker’, etc.

• affinity_parameter (string) (optional) Affinity measurement type: ‘pKi’, ‘pIC50’, ‘pEC50’, ‘pKd’, ‘pKB’, ‘pA2’.

• min_affinity (number) (optional) Minimum affinity value (e.g., 7.0 for pKi >= 7). Higher values indicate stronger binding. Note: This parameter may not be supported by the API - consider filtering results after retrieval instead.

• approved_only (boolean) (optional) Return only interactions with approved drugs (true/false).

• limit (integer) (optional) Maximum number of interactions to return (default: 100, max: 5000).

Example Usage:

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

Navigation

• Available Tools - Back to Tools Overview

• Tool Loading Tutorial - Loading Local Tools