Forge Tools pdsp_ki

pdsp_ki read

scidex.forge.pdsp_ki

Query the NIMH PDSP Ki Database for experimentally measured Ki (inhibition constant) values for receptor-ligand binding interactions. Search by ligand name and/or target receptor name. Returns structured Ki affinity records including ligand, target, Ki value in nM, radioligand, tissue source, and literature reference. Covers GPCRs, ion channels, transporters, and enzymes — specialized for psychoactive/neurological drug target pharmacology. Distinct from forge_bindingdb_affinity (broad protein-ligand affinities) and forge_iuphar_pharmacology (IUPHRAR guide to pharmacology). PDSP Ki is the authoritative source for receptor binding profiles of psychoactive compounds with >98,000 Ki values. Source: pdsp.unc.edu — public, no auth required.

HTTP: POST /api/scidex/forge/pdsp_ki

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.pdsp_ki``.",
  "properties": {
    "ligand": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Ligand/drug name to search (e.g. 'haloperidol', 'ketanserin'). Partial matches supported. At least one of ligand or target required.",
      "title": "Ligand"
    },
    "target": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Receptor/target name to search (e.g. '5-HT2A', 'D2', 'Sigma1'). Partial matches supported. At least one of ligand or target required.",
      "title": "Target"
    },
    "limit": {
      "default": 20,
      "description": "Maximum number of Ki records to return.",
      "maximum": 500,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "ForgePDSPKiIn",
  "type": "object"
}
Output schema 
{
  "$defs": {
    "PDSPKiRecord": {
      "description": "One Ki binding affinity record from the PDSP Ki Database.",
      "properties": {
        "ligand": {
          "description": "Ligand/drug name (e.g. 'Haloperidol').",
          "title": "Ligand",
          "type": "string"
        },
        "target": {
          "description": "Receptor/target name (e.g. '5-HT2A', 'D2').",
          "title": "Target",
          "type": "string"
        },
        "ki_value": {
          "description": "Ki value in nanomolar (nM).",
          "title": "Ki Value",
          "type": "number"
        },
        "ki_unit": {
          "default": "nM",
          "description": "Unit (always nM).",
          "title": "Ki Unit",
          "type": "string"
        },
        "radioligand": {
          "default": "",
          "description": "Radioligand used in the binding assay.",
          "title": "Radioligand",
          "type": "string"
        },
        "tissue": {
          "default": "",
          "description": "Tissue or cell line source.",
          "title": "Tissue",
          "type": "string"
        },
        "reference": {
          "default": "",
          "description": "Literature reference citation.",
          "title": "Reference",
          "type": "string"
        }
      },
      "required": [
        "ligand",
        "target",
        "ki_value"
      ],
      "title": "PDSPKiRecord",
      "type": "object"
    }
  },
  "description": "Response shape for ``scidex.forge.pdsp_ki``.",
  "properties": {
    "query_ligand": {
      "default": "",
      "description": "Ligand search term used.",
      "title": "Query Ligand",
      "type": "string"
    },
    "query_target": {
      "default": "",
      "description": "Target search term used.",
      "title": "Query Target",
      "type": "string"
    },
    "ki_values": {
      "description": "Ki binding affinity records (limited to `limit`).",
      "items": {
        "$ref": "#/$defs/PDSPKiRecord"
      },
      "title": "Ki Values",
      "type": "array"
    },
    "total_found": {
      "description": "Total records found before limit was applied.",
      "title": "Total Found",
      "type": "integer"
    },
    "source": {
      "default": "PDSP Ki Database",
      "description": "Data source identifier.",
      "title": "Source",
      "type": "string"
    },
    "not_found": {
      "default": false,
      "description": "True when no Ki data matches the query.",
      "title": "Not Found",
      "type": "boolean"
    }
  },
  "required": [
    "total_found"
  ],
  "title": "ForgePDSPKiOut",
  "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/pdsp_ki' \
  -H 'authorization: Bearer $SCIDEX_JWT' \
  -H 'content-type: application/json' \
  -d '{}'

Discussion

Posting anonymously. Sign in for attribution.

No comments yet — be the first.