Variant 3-D Structural Triage
triage_variant_3dRetrieves source-reported variant evidence and fuses ClinVar pathogenicity with gnomAD gene-constraint signals into a prioritised research report, showing source status and lookup failures.
Instructions
Retrieve source-reported variant evidence for research.
Fuses the upstream signals this tool currently wires into a single prioritised report:
Pathogenicity — ClinVar interpretation + review status. The
alphamissense_score/alphamissense_interpretationfields are alwaysnull/ "Not available" here: AlphaMissense is not wired into this tool. For an AlphaMissense pathogenicity score usegenerate_variant_clinical_report.Population genetics — gnomAD LOEUF / pLI gene-constraint scores. Per-variant allele frequencies and the per-ancestry breakdown are not wired into this tool.
Disease associations — a placeholder note pointing at
get_target_diseases(); the Open Targets / MONDO traversal is a roadmap (Wave-3) item.Structural context — a text note pointing at
analyze_structural_confidence(resolve the gene to a UniProt accession first); the AlphaFold pLDDT / PAE join into this report is a roadmap (Wave-3) item.
Returns the legacy pathogenicity_tier key as NOT_ASSESSED. Raw
verified ClinVar classifications remain source-attributed in the
pathogenicity section; they are not converted into a local risk tier.
Gene-relative candidates remain explicitly unverified. AlphaMissense
is not wired into this particular tool. The report is not a calibrated risk estimate.
status summarises the evidence lookups that were attempted:
success when none failed, partial when some failed and some
answered, error when all failed and no source evidence was retrieved.
data_sources_status gives each source's state, and lookup_summary
groups the sources into attempted, answered, failed and
skipped with a reason for each failure. A lookup that finds nothing
(no_data) is an answer. gnomAD is skipped, and counts neither way,
when include_gnomad is false or a transcript's gene could not be
verified. A failed lookup is not evidence about the variant: the fields
it feeds keep their defaults (clinvar_classification "Not provided",
empty population_genetics).
Example: triage_variant_3d(hgvs='BRCA1:c.181T>G')
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"params": "<params>"
},
"name": "triage_variant_3d"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |