Forge Tools drugbank_interactions

drugbank_interactions read

scidex.forge.drugbank_interactions

Query DrugBank (drugbank.ca) for drug-target pharmacology records. DrugBank is the gold-standard drug-target database combining FDA-approved drugs, clinical-trial candidates, and experimental compounds with curated mechanisms of action, drug classes, target gene symbols, CAS numbers, and known interaction drugs. Complements ChEMBL bioactivity (forge_chembl_activity) with mechanistic pharmacology context. Supports query by drug name (fuzzy), DrugBank ID (exact), or target gene symbol. REST API: https://go.drugbank.com/api/v1 — free, no auth required.

HTTP: POST /api/scidex/forge/drugbank_interactions

Invoke

Calls scidex.tool.invoke on the substrate with this tool name. Edit the JSON below — it must match the input schema. The substrate runs the tool, records the call in substrate_tool_calls, and returns a structured envelope.

Sign in to invoke this tool. Schema and curl snippet are visible to anyone.

Schemas

Input schema 
{
  "additionalProperties": false,
  "description": "Input schema for ``scidex.forge.drugbank_interactions``.",
  "properties": {
    "query": {
      "description": "Query term — drug name (default), DrugBank ID (e.g. 'DB00102'), or target gene symbol.  Interpretation is controlled by ``query_type``.",
      "maxLength": 200,
      "title": "Query",
      "type": "string"
    },
    "query_type": {
      "default": "drug_name",
      "description": "How to interpret ``query``.  ``'drug_name'`` — fuzzy match on drug name (default); ``'drugbank_id'`` — exact match on DrugBank ID; ``'target_gene'`` — drugs acting on the given gene symbol.",
      "title": "Query Type",
      "type": "string"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of drug records to return (default 20, max 100).",
      "maximum": 100,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "query"
  ],
  "title": "ForgeDrugBankInteractionsIn",
  "type": "object"
}
Output schema 
{
  "$defs": {
    "DrugBankInteraction": {
      "description": "One drug-target interaction record from DrugBank.",
      "properties": {
        "drugbank_id": {
          "description": "DrugBank unique identifier (e.g. 'DB00102').",
          "title": "Drugbank Id",
          "type": "string"
        },
        "drug_name": {
          "description": "Primary drug name (brand or generic).",
          "title": "Drug Name",
          "type": "string"
        },
        "drug_type": {
          "default": "",
          "description": "Drug type: 'Approved', 'Investigational', 'Experimental', etc.",
          "title": "Drug Type",
          "type": "string"
        },
        "cas_number": {
          "default": "",
          "description": "CAS Registry Number for the drug compound.",
          "title": "Cas Number",
          "type": "string"
        },
        "target_gene": {
          "default": "",
          "description": "HGNC gene symbol of the reported drug target.",
          "title": "Target Gene",
          "type": "string"
        },
        "pharmacological_action": {
          "default": "",
          "description": "Pharmacological action class (e.g. 'Kinase Inhibitor', 'Proton Pump Inhibitor', 'Anticoagulant').",
          "title": "Pharmacological Action",
          "type": "string"
        },
        "moa_description": {
          "default": "",
          "description": "Mechanism of action free-text description as curated by DrugBank.",
          "title": "Moa Description",
          "type": "string"
        },
        "clinical_status": {
          "default": "",
          "description": "Clinical development status: 'approved', 'investigational', 'experimental', 'withdrawn', 'nutraceutical', etc.",
          "title": "Clinical Status",
          "type": "string"
        },
        "known_interactions": {
          "description": "Drug names of other drugs known to interact with this drug.",
          "items": {
            "type": "string"
          },
          "title": "Known Interactions",
          "type": "array"
        }
      },
      "required": [
        "drugbank_id",
        "drug_name"
      ],
      "title": "DrugBankInteraction",
      "type": "object"
    }
  },
  "description": "Response shape for ``scidex.forge.drugbank_interactions``.",
  "properties": {
    "query": {
      "description": "The input query term, echoed back.",
      "title": "Query",
      "type": "string"
    },
    "query_type": {
      "description": "The input query type, echoed back.",
      "title": "Query Type",
      "type": "string"
    },
    "drugs": {
      "description": "Drug records from DrugBank matching the query.",
      "items": {
        "$ref": "#/$defs/DrugBankInteraction"
      },
      "title": "Drugs",
      "type": "array"
    },
    "not_found": {
      "default": false,
      "description": "True when DrugBank returned no matching drug records.",
      "title": "Not Found",
      "type": "boolean"
    },
    "took_ms": {
      "description": "Wall-clock time for upstream API calls in ms.",
      "title": "Took Ms",
      "type": "integer"
    }
  },
  "required": [
    "query",
    "query_type",
    "took_ms"
  ],
  "title": "ForgeDrugBankInteractionsOut",
  "type": "object"
}

curl snippet

Replace $SCIDEX_JWT with a valid bearer token. Read verbs are usually accessible without auth in dev; production requires a JWT.

curl -sS -X POST '/api/scidex/forge/drugbank_interactions' \
  -H 'authorization: Bearer $SCIDEX_JWT' \
  -H 'content-type: application/json' \
  -d '{
  "query": ""
}'

Discussion

Posting anonymously. Sign in for attribution.

No comments yet — be the first.