variants
Retrieve single-variant association results for a trait, genome-wide or within a specific gene, with per-biobank effect direction and cross-biobank replication evidence.
Instructions
Single-variant results for a trait, genome-wide or inside one gene.
Drops below the gene-level burden tests to the individual variants carrying a
signal. Without gene this ranks the whole genome for the trait; with gene
it restricts to that gene and adds the per-biobank effect-direction tally,
the cross-biobank replication evidence.
Still fetched over HTTP rather than shipped in the database: the variant-level format is a separate, actively changing upstream release, an order of magnitude larger than the gene-level table, and rebuilt often enough that a local copy would be stale within the week. Each file is cached permanently once fetched.
Each row links to gnomAD, where population allele frequencies live.
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": {
"phenotype": "<phenotype>"
},
"name": "variants"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gene | No | Restrict to one gene. Omit for the genome-wide scan. | |
| chrom | No | Restrict the genome-wide scan to one chromosome ("2", "X"). | |
| limit | No | Max rows (default 25). | |
| max_p | No | p-value ceiling. The variant-level threshold is 1.82e-8. | |
| offset | No | Skip this many rows, to page through a long result set. | |
| ancestry | No | All (cross-ancestry meta, default) or a specific stratum. Only meaningful together with `gene`. | All |
| phenotype | Yes | Trait id or name. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |