genomi-gnomad

name	genomi-gnomad
description	Fetch reusable public population allele frequencies from gnomAD for a specific variant. Use when the user asks about allele frequency, MAF, population stratification, gnomAD numbers, or rarity of a specific allele.
tools	["genomi.invoke"]
mutating	true

Population Frequency (gnomAD)

Fetch public gnomAD population allele frequencies for one variant. Results are cached locally in the evidence database so subsequent queries reuse them.

Activation

To call the tool below, invoke it through the MCP dispatcher:

genomi.invoke({
  "tool": "gnomad.fetch_population_frequency",
  "params": {
    "chrom": "19",
    "pos": 44908684,
    "ref": "T",
    "alt": "C",
    "genome_build": "GRCh38"
  }
})

The dispatcher validates the params against the underlying tool's input schema and returns the underlying tool's response with an added dispatched_tool field.

When to use this skill

• "What is the gnomAD frequency of rs429358?"
• "Is this variant rare in gnomAD?"
• "Allele frequency in African populations for rs1042522."
• Any question that needs MAF, AF, population-stratified counts.

Boundaries

• Variant-anchored only — query one allele at a time.
• Public population data only — does not read the user's Active Genome Index.
• Cached after first fetch — subsequent queries for the same variant reuse the local evidence store.

Cross-Capability Synthesis

A scope-limited result from this capability is not a final user-facing answer when other Genomi capabilities can contribute orthogonal evidence to the same question. Returning "cannot answer" while applicable capabilities remain unexamined is a host-agent failure mode.

Tools

gnomad.fetch_population_frequency

Fetch reusable gnomAD public population frequency for one allele and write it into evidence storage.

Use when: The agent needs gnomAD allele frequency, MAF, or population-stratified counts for a specific variant (rsID, chrom/pos/ref/alt, or VCF locus).

Why necessary: gnomAD is the canonical public population frequency source; cached results keep subsequent calls cheap.

Not for: Genome-wide rare-variant screening, ad-hoc curated annotations, anything not anchored to a specific variant.

Example prompts: What's the gnomAD frequency of rs429358? Is rs1042522 rare in East Asian populations?

Result semantics: Returns the gnomAD record with population-stratified counts and frequencies plus a populations block; writes to the local evidence database for reuse.