Forge Tools kegg_drug

kegg_drug read

scidex.forge.kegg_drug

Look up approved drug entries from the KEGG DRUG database. For each drug name or KEGG DRUG ID (D00001 format), returns the primary name, synonyms, molecular formula and weight, protein targets with HGNC gene symbols and KEGG HSA IDs, ATC pharmacological classification codes, therapeutic efficacy description, and approval status remarks. Distinct from forge_kegg_pathways (biological pathway lookup by gene) and forge_chembl_compound (bioactivity IC50/Ki data). KEGG DRUG is the authoritative source for approved drug-target mappings and ATC codes. Up to 10 queries per call; up to 3 concurrent requests. Not-found queries go to the not_found list — not an exception. API: rest.kegg.jp — public, no auth required.

HTTP: POST /api/scidex/forge/kegg_drug

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.kegg_drug``.",
  "properties": {
    "queries": {
      "description": "Drug names or KEGG DRUG IDs to look up. Examples: ['aspirin', 'D00001', 'ibuprofen']. KEGG DRUG IDs (D followed by 5 digits) are fetched directly; drug names are searched via the KEGG /find endpoint. Maximum 10 queries per call.",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "title": "Queries",
      "type": "array"
    }
  },
  "required": [
    "queries"
  ],
  "title": "ForgeKEGGDrugIn",
  "type": "object"
}
Output schema 
{
  "$defs": {
    "KEGGDrugEntry": {
      "description": "One KEGG DRUG entry.",
      "properties": {
        "drug_id": {
          "description": "KEGG DRUG ID (e.g. 'D00001').",
          "title": "Drug Id",
          "type": "string"
        },
        "name": {
          "description": "Primary drug name.",
          "title": "Name",
          "type": "string"
        },
        "synonyms": {
          "description": "Alternative names and synonyms.",
          "items": {
            "type": "string"
          },
          "title": "Synonyms",
          "type": "array"
        },
        "formula": {
          "default": "",
          "description": "Molecular formula (e.g. 'C14H8Cl4').",
          "title": "Formula",
          "type": "string"
        },
        "mol_weight": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Molecular weight (Da).",
          "title": "Mol Weight"
        },
        "targets": {
          "description": "Protein targets with gene symbols and KEGG HSA IDs.",
          "items": {
            "$ref": "#/$defs/KEGGDrugTarget"
          },
          "title": "Targets",
          "type": "array"
        },
        "atc_codes": {
          "description": "ATC classification codes (e.g. ['N02BA01']).",
          "items": {
            "type": "string"
          },
          "title": "Atc Codes",
          "type": "array"
        },
        "efficacy": {
          "default": "",
          "description": "Drug efficacy/therapeutic use description.",
          "title": "Efficacy",
          "type": "string"
        },
        "approval_remarks": {
          "description": "Approval status remarks (e.g. ['Japan: approved', 'US: approved']).",
          "items": {
            "type": "string"
          },
          "title": "Approval Remarks",
          "type": "array"
        },
        "kegg_url": {
          "default": "",
          "description": "KEGG DRUG entry URL.",
          "title": "Kegg Url",
          "type": "string"
        }
      },
      "required": [
        "drug_id",
        "name"
      ],
      "title": "KEGGDrugEntry",
      "type": "object"
    },
    "KEGGDrugTarget": {
      "description": "One protein target for a KEGG DRUG entry.",
      "properties": {
        "gene_symbol": {
          "description": "Human gene symbol for the target (e.g. 'PTGS2').",
          "title": "Gene Symbol",
          "type": "string"
        },
        "target_name": {
          "default": "",
          "description": "Full target protein name/description.",
          "title": "Target Name",
          "type": "string"
        },
        "hsa_gene_id": {
          "default": "",
          "description": "KEGG HSA gene ID (e.g. 'hsa:5743').",
          "title": "Hsa Gene Id",
          "type": "string"
        }
      },
      "required": [
        "gene_symbol"
      ],
      "title": "KEGGDrugTarget",
      "type": "object"
    }
  },
  "description": "Response shape for ``scidex.forge.kegg_drug``.",
  "properties": {
    "drugs": {
      "description": "KEGG DRUG entries for found queries.",
      "items": {
        "$ref": "#/$defs/KEGGDrugEntry"
      },
      "title": "Drugs",
      "type": "array"
    },
    "not_found": {
      "description": "Queries that did not match any KEGG DRUG entry.",
      "items": {
        "type": "string"
      },
      "title": "Not Found",
      "type": "array"
    },
    "took_ms": {
      "description": "Wall-clock time for all upstream API calls.",
      "title": "Took Ms",
      "type": "integer"
    }
  },
  "required": [
    "took_ms"
  ],
  "title": "ForgeKEGGDrugOut",
  "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/kegg_drug' \
  -H 'authorization: Bearer $SCIDEX_JWT' \
  -H 'content-type: application/json' \
  -d '{
  "queries": []
}'

Discussion

Posting anonymously. Sign in for attribution.

No comments yet — be the first.