Gtopdb Tools¶
Configuration File: gtopdb_tools.json
Tool Type: Local
Tools Count: 6
This page contains all tools defined in the gtopdb_tools.json configuration file.
Available Tools¶
GtoPdb_get_disease_associations (Type: GtoPdbRESTTool)¶
Get curated disease-to-target and disease-to-ligand associations from the Guide to Pharmacology (…
GtoPdb_get_disease_associations tool specification
Tool Information:
Name:
GtoPdb_get_disease_associationsType:
GtoPdbRESTToolDescription: Get curated disease-to-target and disease-to-ligand associations from the Guide to Pharmacology (GtoPdb / IUPHAR-BPS) for a given disease ID. Merges two keyless endpoints into one record: diseaseTargets (drug targets linked to the disease, with roles, references, and ligand-target interactions) and diseaseLigands (approved/experimental ligands linked to the disease, with approval status and clinical-use notes). An empty list is a valid result (some diseases have targets but no curated ligands). Use GtoPdb_search_diseases first to find a disease_id (e.g., non-allergic asthma = 1161). No authentication required.
Parameters:
disease_id([‘integer’, ‘null’]) (optional) GtoPdb disease ID. Get from GtoPdb_search_diseases. Examples: 1161 (non-allergic asthma), 34 (acute myeloid leukemia). Alias: diseaseId also accepted.diseaseId([‘integer’, ‘null’]) (optional) Alias for disease_id. GtoPdb disease ID.
Example Usage:
query = {
"name": "GtoPdb_get_disease_associations",
"arguments": {
}
}
result = tu.run(query)
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_interactionsType:
GtoPdbRESTToolDescription: 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_get_ligand_properties (Type: GtoPdbRESTTool)¶
Get the chemical structure and computed molecular properties of a ligand from the Guide to Pharma…
GtoPdb_get_ligand_properties tool specification
Tool Information:
Name:
GtoPdb_get_ligand_propertiesType:
GtoPdbRESTToolDescription: Get the chemical structure and computed molecular properties of a ligand from the Guide to Pharmacology (GtoPdb / IUPHAR-BPS) by its ligand ID. Merges two keyless endpoints into one record: structure (canonical SMILES, InChI, InChIKey, IUPAC name) and molecularProperties (molecular weight, logP, hydrogen-bond donors/acceptors, rotatable bonds, topological polar surface area, Lipinski rule-of-five violation count). Use GtoPdb_search_ligands first to find a ligand_id (e.g., aspirin = 4139). No authentication required.
Parameters:
ligand_id([‘integer’, ‘null’]) (optional) GtoPdb ligand ID. Get from GtoPdb_search_ligands. Examples: 4139 (aspirin), 1 (a-bungarotoxin). Alias: ligandId also accepted.ligandId([‘integer’, ‘null’]) (optional) Alias for ligand_id. GtoPdb ligand ID.
Example Usage:
query = {
"name": "GtoPdb_get_ligand_properties",
"arguments": {
}
}
result = tu.run(query)
GtoPdb_search_diseases (Type: GtoPdbRESTTool)¶
Search the Guide to Pharmacology (GtoPdb / IUPHAR-BPS) for diseases by name, and retrieve their c…
GtoPdb_search_diseases tool specification
Tool Information:
Name:
GtoPdb_search_diseasesType:
GtoPdbRESTToolDescription: Search the Guide to Pharmacology (GtoPdb / IUPHAR-BPS) for diseases by name, and retrieve their curated disease IDs, names, synonyms, and cross-references to external databases (OMIM, Orphanet, Disease Ontology). GtoPdb links diseases to the drug targets and approved/experimental ligands relevant to them. Example: ‘epilepsy’ returns disease entries such as ‘Epilepsy and Intellectual Disability’. No authentication required.
Parameters:
name([‘string’, ‘null’]) (optional) Disease name to search. Examples: ‘epilepsy’, ‘asthma’, ‘hypertension’, ‘breast cancer’.query([‘string’, ‘null’]) (optional) Name/keyword to search for. Alias for the “name” parameter.
Example Usage:
query = {
"name": "GtoPdb_search_diseases",
"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_ligandsType:
GtoPdbRESTToolDescription: 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_targetsType:
GtoPdbRESTToolDescription: 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)