Forge Tools drugcentral_lookup

drugcentral_lookup read

scidex.forge.drugcentral_lookup

Look up drugs in DrugCentral — a curated open database of drug-target-indication associations. For each drug name, returns the DrugCentral ID, canonical name, synonyms, WHO ATC codes, curated protein targets (gene_symbol, target_class, action_type), and disease indications (disease_name, umls_cui). Complements ChEMBL, PharmGKB, and Pharos with curated clinical associations. REST API: https://drugcentral.org/api/v1 — public, no auth required.

HTTP: POST /api/scidex/forge/drugcentral_lookup

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.drugcentral_lookup``.",
  "properties": {
    "drug_names": {
      "description": "Drug names to look up (generic or brand, e.g. ``['aspirin', 'metformin']``). Each name is resolved to the single best DrugCentral match.",
      "items": {
        "type": "string"
      },
      "title": "Drug Names",
      "type": "array"
    },
    "include_targets": {
      "default": true,
      "description": "When True (default), include drug-target relationships (gene_symbol, target_class, action_type) in the response.",
      "title": "Include Targets",
      "type": "boolean"
    },
    "include_indications": {
      "default": true,
      "description": "When True (default), include disease indications (disease_name, umls_cui) in the response.",
      "title": "Include Indications",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of drugs to return across all queried names.",
      "maximum": 50,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "drug_names"
  ],
  "title": "ForgeDrugCentralIn",
  "type": "object"
}
Output schema 
{
  "$defs": {
    "DrugCentralEntry": {
      "description": "One DrugCentral drug record.",
      "properties": {
        "dc_id": {
          "description": "DrugCentral numeric identifier.",
          "title": "Dc Id",
          "type": "integer"
        },
        "name": {
          "description": "Canonical drug name.",
          "title": "Name",
          "type": "string"
        },
        "synonyms": {
          "description": "Brand names and alternative drug name spellings.",
          "items": {
            "type": "string"
          },
          "title": "Synonyms",
          "type": "array"
        },
        "atc_codes": {
          "description": "WHO ATC classification codes (e.g. ``'N02BA01'`` for aspirin).",
          "items": {
            "type": "string"
          },
          "title": "Atc Codes",
          "type": "array"
        },
        "targets": {
          "description": "Curated drug-target relationships.",
          "items": {
            "$ref": "#/$defs/DrugCentralTarget"
          },
          "title": "Targets",
          "type": "array"
        },
        "indications": {
          "description": "Approved and investigational disease indications.",
          "items": {
            "$ref": "#/$defs/DrugCentralIndication"
          },
          "title": "Indications",
          "type": "array"
        }
      },
      "required": [
        "dc_id",
        "name"
      ],
      "title": "DrugCentralEntry",
      "type": "object"
    },
    "DrugCentralIndication": {
      "description": "One disease indication from DrugCentral.",
      "properties": {
        "disease_name": {
          "description": "Disease or condition name.",
          "title": "Disease Name",
          "type": "string"
        },
        "umls_cui": {
          "default": "",
          "description": "UMLS concept identifier (e.g. ``'C0030193'``).",
          "title": "Umls Cui",
          "type": "string"
        }
      },
      "required": [
        "disease_name"
      ],
      "title": "DrugCentralIndication",
      "type": "object"
    },
    "DrugCentralTarget": {
      "description": "One drug-target relationship from DrugCentral.",
      "properties": {
        "gene_symbol": {
          "default": "",
          "description": "HGNC gene symbol of the target protein.",
          "title": "Gene Symbol",
          "type": "string"
        },
        "target_class": {
          "default": "",
          "description": "Target class (e.g. ``'enzyme'``, ``'GPCR'``, ``'nuclear receptor'``).",
          "title": "Target Class",
          "type": "string"
        },
        "action_type": {
          "default": "",
          "description": "Pharmacological action type (e.g. ``'inhibitor'``, ``'agonist'``).",
          "title": "Action Type",
          "type": "string"
        }
      },
      "title": "DrugCentralTarget",
      "type": "object"
    }
  },
  "description": "Response shape for ``scidex.forge.drugcentral_lookup``.",
  "properties": {
    "drugs": {
      "description": "DrugCentral records, one per drug name resolved.",
      "items": {
        "$ref": "#/$defs/DrugCentralEntry"
      },
      "title": "Drugs",
      "type": "array"
    },
    "took_ms": {
      "description": "Wall-clock time for all upstream calls.",
      "title": "Took Ms",
      "type": "integer"
    }
  },
  "required": [
    "took_ms"
  ],
  "title": "ForgeDrugCentralOut",
  "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/drugcentral_lookup' \
  -H 'authorization: Bearer $SCIDEX_JWT' \
  -H 'content-type: application/json' \
  -d '{
  "drug_names": []
}'

Discussion

Posting anonymously. Sign in for attribution.

No comments yet — be the first.