drugcomb_synergy read
scidex.forge.drugcomb_synergy
Query DrugComb (drugcomb.org) for drug-combination synergy scores. DrugComb is a curated database of drug pair synergy measured across thousands of cancer cell lines using dose-response matrix experiments. Synergy is quantified using five metrics: CSS (Combination Synergy Score), ZIP, Bliss, Loewe, and HSA. Provide drug_1 and drug_2 (drug names or IDs); optionally filter by cell_line ID (e.g. 'MCF7', 'A549', 'PC3'). Returns synergy scores, IC50 values, and CSS percentile rank for each drug–cell-line combination. Distinct from forge_drugbank_interactions (mechanism/pharmacology), forge_chembl_activity (single-drug IC50/Ki), and forge_kegg_drug (approved drug entries). API: https://api.drugcomb.org — free, no auth required.
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.drugcomb_synergy``.",
"properties": {
"drug_1": {
"description": "First drug in the pair. Can be a drug name (e.g. ``'cisplatin'``, ``'paclitaxel'``) or a DrugComb drug ID.",
"maxLength": 200,
"title": "Drug 1",
"type": "string"
},
"drug_2": {
"description": "Second drug in the pair. Can be a drug name (e.g. ``'cisplatin'``, ``'paclitaxel'``) or a DrugComb drug ID.",
"maxLength": 200,
"title": "Drug 2",
"type": "string"
},
"cell_line": {
"anyOf": [
{
"maxLength": 100,
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Optional cancer cell line ID to filter results (e.g. ``'MCF7'``, ``'A549'``, ``'PC3'``). When ``None`` (default), all cell lines are returned.",
"title": "Cell Line"
},
"limit": {
"default": 50,
"description": "Maximum number of synergy records to return (default 50, max 500). Results are sorted by CSS descending.",
"maximum": 500,
"minimum": 1,
"title": "Limit",
"type": "integer"
}
},
"required": [
"drug_1",
"drug_2"
],
"title": "ForgeDrugcombSynergyIn",
"type": "object"
}Output schema
{
"$defs": {
"DrugSynergyResult": {
"description": "One drug-combination synergy record from DrugComb.",
"properties": {
"drug_1": {
"description": "Name or identifier of the first drug.",
"title": "Drug 1",
"type": "string"
},
"drug_2": {
"description": "Name or identifier of the second drug.",
"title": "Drug 2",
"type": "string"
},
"cell_line": {
"description": "Cancer cell line ID (e.g. 'MCF7', 'A549').",
"title": "Cell Line",
"type": "string"
},
"synergy_css": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Combination Synergy Score (CSS). Higher values indicate stronger synergy. Derived from drug combination index analysis. None when not available in the source data.",
"title": "Synergy Css"
},
"synergy_zip": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "ZIP (zero-interaction potency) synergy score.",
"title": "Synergy Zip"
},
"synergy_bliss": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Bliss independence model synergy score.",
"title": "Synergy Bliss"
},
"synergy_loewe": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Loewe additivity model synergy score.",
"title": "Synergy Loewe"
},
"synergy_hsa": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Highest single-agent (HSA) synergy score.",
"title": "Synergy Hsa"
},
"ic50_1": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "IC50 of drug 1 in the combination experiment (μM).",
"title": "Ic50 1"
},
"ic50_2": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "IC50 of drug 2 in the combination experiment (μM).",
"title": "Ic50 2"
},
"css_PRI": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "CSS Percentile Rank Indicator — the percentile rank of this combination's CSS among all combinations in DrugComb (0–100).",
"title": "Css Pri"
},
"source": {
"default": "DrugComb (drugcomb.org)",
"description": "Data source attribution.",
"title": "Source",
"type": "string"
}
},
"required": [
"drug_1",
"drug_2",
"cell_line"
],
"title": "DrugSynergyResult",
"type": "object"
}
},
"description": "Response shape for ``scidex.forge.drugcomb_synergy``.",
"properties": {
"drug_1": {
"description": "The first drug queried, echoed back.",
"title": "Drug 1",
"type": "string"
},
"drug_2": {
"description": "The second drug queried, echoed back.",
"title": "Drug 2",
"type": "string"
},
"cell_line": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The cell line filter used, or ``None`` if all cell lines.",
"title": "Cell Line"
},
"results": {
"description": "Synergy records for this drug pair, sorted by CSS descending, capped at ``limit``.",
"items": {
"$ref": "#/$defs/DrugSynergyResult"
},
"title": "Results",
"type": "array"
},
"total_found": {
"default": 0,
"description": "Total number of synergy records available for this drug pair before the ``limit`` was applied.",
"title": "Total Found",
"type": "integer"
},
"not_found": {
"default": false,
"description": "True when DrugComb has no synergy data for this drug pair (and cell_line filter if applied).",
"title": "Not Found",
"type": "boolean"
},
"source": {
"default": "DrugComb (drugcomb.org)",
"description": "Data source attribution.",
"title": "Source",
"type": "string"
},
"took_ms": {
"default": 0,
"description": "Wall-clock time for the upstream API call in milliseconds.",
"title": "Took Ms",
"type": "integer"
}
},
"required": [
"drug_1",
"drug_2",
"cell_line"
],
"title": "ForgeDrugcombSynergyOut",
"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/drugcomb_synergy' \
-H 'authorization: Bearer $SCIDEX_JWT' \
-H 'content-type: application/json' \
-d '{
"drug_1": "",
"drug_2": ""
}'Discussion
No comments yet — be the first.