Gtopdb Tools

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

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

Available Tools

GtoPdb_get_interactions (Type: GtoPdbRESTTool)

Get pharmacological interactions between targets and ligands from the Guide to Pharmacology datab…

GtoPdb_get_interactions tool specification

Tool Information:

  • Name: GtoPdb_get_interactions

  • Type: GtoPdbRESTTool

  • Description: Get pharmacological interactions between targets and ligands from the Guide to Pharmacology database. Provide gene_symbol (convenience, auto-resolves to targetId), targetId (from GtoPdb_search_targets), or ligandId (from GtoPdb_search_ligands) to filter interactions. Returns binding affinity (Ki, Kd, IC50, EC50), action type (agonist, antagonist, inhibitor, etc.), species, and assay information. NOTE: GtoPdb coverage focuses on GPCRs, ion channels, nuclear receptors, and enzymes; kinase inhibitors (EGFR, BRAF, ALK, VEGFR inhibitors) have limited interaction data — use ChEMBL_get_drug_mechanisms for those instead. No authentication required.

Parameters:

  • gene_symbol ([‘string’, ‘null’]) (optional) Gene symbol convenience parameter — automatically resolves to GtoPdb targetId. Works for gene-symbol-named targets (e.g., ‘KRAS’, ‘EGFR’, ‘BRAF’, ‘ALK’). Traditional receptor names like ‘DRD2’ may not resolve; use GtoPdb_search_targets first to confirm. Prefer exact gene symbols over partial names.

  • targetId ([‘integer’, ‘null’]) (optional) GtoPdb target ID. Get from GtoPdb_search_targets. Examples: 2486 (dopamine beta-hydroxylase), 20 (5-HT1A receptor). Alias: target_id also accepted.

  • target_id ([‘integer’, ‘null’]) (optional) Alias for targetId. GtoPdb target ID.

  • ligandId ([‘integer’, ‘null’]) (optional) GtoPdb ligand ID. Get from GtoPdb_search_ligands. Examples: 5765 (aspirin), 7093 (morphine)

  • species ([‘string’, ‘null’]) (optional) Filter by species. Examples: ‘Human’, ‘Mouse’, ‘Rat’

Example Usage:

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

GtoPdb_search_ligands (Type: GtoPdbRESTTool)

Search the Guide to Pharmacology database for pharmacological ligands (drugs, natural products, e…

GtoPdb_search_ligands tool specification

Tool Information:

  • Name: GtoPdb_search_ligands

  • Type: GtoPdbRESTTool

  • Description: Search the Guide to Pharmacology database for pharmacological ligands (drugs, natural products, endogenous compounds). Returns ligand details including type, approval status, INN name, WHO essential medicine status, and whether it is an approved drug. GtoPdb covers 10,000+ curated ligands with pharmacological activity data. No authentication required.

Parameters:

  • name ([‘string’, ‘null’]) (optional) Ligand name or INN to search. Examples: ‘aspirin’, ‘morphine’, ‘dopamine’, ‘caffeine’, ‘insulin’

  • type ([‘string’, ‘null’]) (optional) Ligand type filter. Values: ‘Approved’, ‘Synthetic organic’, ‘Natural product’, ‘Endogenous peptide’, ‘Antibody’, ‘Inorganic’

  • approved ([‘boolean’, ‘null’]) (optional) Filter to approved drugs only (true) or all ligands (false/omit)

  • query ([‘string’, ‘null’]) (optional) Name/keyword to search for. Alias for the “name” parameter.

Example Usage:

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

GtoPdb_search_targets (Type: GtoPdbRESTTool)

Search the Guide to Pharmacology database (GtoPdb) for drug targets including GPCRs, ion channels…

GtoPdb_search_targets tool specification

Tool Information:

  • Name: GtoPdb_search_targets

  • Type: GtoPdbRESTTool

  • Description: Search the Guide to Pharmacology database (GtoPdb) for drug targets including GPCRs, ion channels, nuclear receptors, enzymes, transporters, and catalytic receptors. Returns target IDs, names, abbreviations, types, and family classifications. GtoPdb is the IUPHAR/BPS reference resource for pharmacological drug targets with 3000+ curated targets. No authentication required.

Parameters:

  • name ([‘string’, ‘null’]) (optional) Target name or gene symbol to search. Examples: ‘dopamine’, ‘serotonin receptor’, ‘EGFR’, ‘beta-adrenoceptor’, ‘TRPV1’

  • type ([‘string’, ‘null’]) (optional) Target type filter. Values: ‘GPCR’, ‘Ion channel’, ‘Nuclear receptor’, ‘Enzyme’, ‘Transporter’, ‘Catalytic receptor’

  • query ([‘string’, ‘null’]) (optional) Name/keyword to search for. Alias for the “name” parameter.

Example Usage:

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