Cortexa research tool·genomics·Immunology

VDJDB Get Antigen Specificity

Search VDJdb by epitope peptide sequence to find all TCRs with confirmed specificity for a given antigen. Returns CDR3 sequences, V/J gene usage, MHC restriction, and confidence scores for TCRs recognizing the epitope. Filter by species, TCR chain, MHC class (MHCI/MHCII), and minimum VDJdb confidence score (0-3). Connects to IEDB epitope tools upstream and IMGT nomenclature downstream.

Livelast probed 2026-04-30 23:07Z· 125msCortexa

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed: 1d ago
Last success: 1d ago
Last latency: 125ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "epitope": {
      "description": "Epitope peptide sequence to search (e.g., 'GILGFVFTL' for Influenza M1, 'GLCTLVAML' for EBV BMLF1)",
      "type": "string"
    },
    "gene": {
      "description": "TCR chain filter: TRA (alpha) or TRB (beta)",
      "type": [
        "string",
        "null"
      ]
    },
    "mhc_class": {
      "description": "MHC class filter: MHCI or MHCII",
      "type": [
        "string",
        "null"
      ]
    },
    "min_score": {
      "description": "Minimum VDJdb confidence score (0-3). Score 3 = highest confidence with multiple verification methods.",
      "type": [
        "integer",
        "null"
      ]
    },
    "operation": {
      "description": "Operation type",
      "enum": [
        "get_antigen_specificity"
      ],
      "type": "string"
    },
    "page": {
      "default": 0,
      "description": "Page number (0-indexed) for paginated results",
      "minimum": 0,
      "type": "integer"
    },
    "page_size": {
      "default": 25,
      "description": "Number of results per page (default: 25, max: 100)",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "species": {
      "description": "Species filter: HomoSapiens, MusMusculus, or MacacaMulatta",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "operation",
    "epitope"
  ],
  "type": "object"
}

Examples (1)

Default VDJDB Get Antigen Specificity call

public-safeinput

{
  "epitope": "",
  "operation": "",
  "page": 1,
  "page_size": 1
}

Expected response keys: success

Anonymous-safe example. Rate-limited; no sign-in required.

Identifiers

Catalog ID: tu_VDJDB_get_antigen_specificity
Tool name: VDJDB_get_antigen_specificity
Added: 2026-04-30 22:47Z
Tags: tooluniverse

VDJDB Get Antigen Specificity

Livelast probed 2026-04-30 23:07Z· 125msCortexa

Schema

JSON Schema the agent (or your API call) must match.

{ "properties": { "epitope": { "description": "Epitope peptide sequence to search (e.g., 'GILGFVFTL' for Influenza M1, 'GLCTLVAML' for EBV BMLF1)", "type": "string" }, "gene": { "description": "TCR chain filter: TRA (alpha) or TRB (beta)", "type": [ "string", "null" ] }, "mhc_class": { "description": "MHC class filter: MHCI or MHCII", "type": [ "string", "null" ] }, "min_score": { "description": "Minimum VDJdb confidence score (0-3). Score 3 = highest confidence with multiple verification methods.", "type": [ "integer", "null" ] }, "operation": { "description": "Operation type", "enum": [ "get_antigen_specificity" ], "type": "string" }, "page": { "default": 0, "description": "Page number (0-indexed) for paginated results", "minimum": 0, "type": "integer" }, "page_size": { "default": 25, "description": "Number of results per page (default: 25, max: 100)", "maximum": 100, "minimum": 1, "type": "integer" }, "species": { "description": "Species filter: HomoSapiens, MusMusculus, or MacacaMulatta", "type": [ "string", "null" ] } }, "required": [ "operation", "epitope" ], "type": "object" }