Worked agent pattern
What does this genetic variant mean? See actual evidence and tool calls
This example shows the sequence of calls and branch decisions. Dated snapshots below record observed results; current classifications and source versions can change.
After inspecting the dated public evidence, review the workflow in Folklore for case-based VCF analysis.
What does a genetic variant evidence result actually contain?
These are selected fields from actual public MCP responses retrieved on 2026-09-11. They are dated examples, not a live result or an independent clinical assessment. One variant call already includes annotation, automated classification, ClinVar assertions, population evidence, predictors when available and source versions.
What is known about BRCA1 c.68_69del?
Exact input: NM_007294.4:c.68_69del. Resolved identity: GRCh38:chr17:43124027:ACT:A.
- Resolved gene and consequence
- BRCA1; frameshift_variant
- Automated Folklore classification
- P (Pathogenic)
- ClinVar assertion
- Pathogenic; reviewed_by_expert_panel; 3 review stars
- gnomAD allele frequency
- 0.0001184799984912388
- gnomAD allele count / number
- 191 / 1612084
- Classifier version
- 3.39.1
ClinVar assertions and the automated Folklore class are separate results. In this example, predictors, SpliceAI and conservation returned no_record; that is not evidence that the variant is benign. Consult the linked source versions when interpreting population values.
Which diseases are associated with FBN1?
A separate get_gene_disease_associations call with gene FBN1 returned the following 3 assertions. These describe gene–disease validity, not the pathogenicity of a particular variant. Disputed assessments are preserved.
- Marfan syndrome
MONDO:0007947 · Definitive · inheritance: AD (autosomal dominant)
General Gene Curation Expert Panel; assessment dated 2019-03-04.
- Shprintzen-Goldberg syndrome
MONDO:0008426 · Disputed · inheritance: AD (autosomal dominant)
Intellectual Disability and Autism Gene Curation Expert Panel; assessment dated 2021-12-01.
- familial thoracic aortic aneurysm and aortic dissection
MONDO:0019625 · Definitive · inheritance: AD (autosomal dominant)
Heritable Thoracic Aortic Aneurysm and Dissection Gene Curation Expert Panel; assessment dated 2017-01-23.
Source: ClinGen Gene-Disease Validity, clingen_gdv_2026-03-16.csv (ClinGen GDV export, FILE CREATED 2026-03-16). Gene-Disease Validity classifications obtained from the Clinical Genome Resource (ClinGen). Source version identifies the local reference export; it is not a claim of current upstream freshness. Coverage is limited to this snapshot. No matching assertion does not establish that a relationship is absent.
{
"name": "get_gene_disease_associations",
"arguments": {
"gene": "FBN1",
"limit": 5,
"offset": 0
}
}Download the dated response fields and source versions (JSON)Try the task
ENST00000226413.5:c.317A>G
Open public variant search to enter one supported GRCh38 germline SNV or simple indel in HGVS, SPDI, rsID or genomic notation. Single supported public queries are free; this does not mean unrestricted platform access or unlimited requests.
No account, API key or OAuth is required. Connect through https://api.helena.bio/folklore/v1/mcp or follow the connector guide.
Minimal call after connecting an MCP client:
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "NM_007294.4:c.68_69del"
}
}See eight requests, tool calls and observed resultsObserved public results: 10 September 2026
These publisher-run snapshots preserve automated results, not clinical conclusions. Classifier 3.39.1 reported ClinVar 2026-01, gnomAD 4.1 and Ensembl VEP Release 113. Source assertions and automated classification remain separate. No record is different from evidence against pathogenicity.
What does NM_007294.4:c.68_69del mean? Show the evidence.
Observed at 2026-09-10T16:37:12Z. Input: NM_007294.4:c.68_69del.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "NM_007294.4:c.68_69del"
}
}Status: resolved; automated class: P.
Report the verified BRCA1 deletion and the returned automated P classification with its criteria and source versions. Require professional review.
Returned criteria and decision-path annotations: PVS1,PS1,BS1_Strong[VCEP][af_grpmax] [VCEP:ENIGMA BRCA1/2 v1.2.0] [ERepo:ENIGMA BRCA1 and BRCA2 VCEP,BRCA1-related cancer predisposition]. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: no_record; dosage: available; expert: available; gene_constraints: available; population: available; predictors: no_record; spliceai: no_record.
Inspect the current exact variantInterpret ENST00000226413.5:c.317A>G and explain the returned criteria.
Observed at 2026-09-10T16:37:23Z. Input: ENST00000226413.5:c.317A>G.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "ENST00000226413.5:c.317A>G"
}
}Status: resolved; automated class: P.
Report the verified GNRHR allele and the returned automated P classification. Explain only the returned criteria and cite the source evidence.
Returned criteria and decision-path annotations: ClinVar,PP3_Supporting. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: available; dosage: no_record; expert: no_record; gene_constraints: available; population: available; predictors: available; spliceai: available.
Inspect the current exact variantCheck the identity and evidence for GRCh38:chr17:43124027:ACT:A.
Observed at 2026-09-10T16:37:33Z. Input: GRCh38:chr17:43124027:ACT:A.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "GRCh38:chr17:43124027:ACT:A"
}
}Status: resolved; automated class: P.
Report the exact normalized GRCh38 allele. Keep ClinVar assertions separate from the automated classification.
Returned criteria and decision-path annotations: PVS1,PS1,BS1_Strong[VCEP][af_grpmax] [VCEP:ENIGMA BRCA1/2 v1.2.0] [ERepo:ENIGMA BRCA1 and BRCA2 VCEP,BRCA1-related cancer predisposition]. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: no_record; dosage: available; expert: available; gene_constraints: available; population: available; predictors: no_record; spliceai: no_record.
Inspect the current exact variantReview this VUS: chr17:43115777 A>G on GRCh38.
Observed at 2026-09-10T16:37:43Z. Input: chr17:43115777 A>G.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "chr17:43115777 A>G"
}
}Status: resolved; automated class: VUS.
Report VUS with the returned criteria and evidence availability. Do not relabel uncertainty as pathogenic or benign.
Returned criteria and decision-path annotations: PM1,PM2_Supporting [VCEP:ENIGMA BRCA1/2 v1.2.0] [ERepo:ENIGMA BRCA1 and BRCA2 VCEP,BRCA1-related cancer predisposition]. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: available; dosage: available; expert: available; gene_constraints: available; population: no_record; predictors: available; spliceai: available.
Inspect the current exact variantReview the classification and available source assertions for chr17:43104953 G>C on GRCh38.
Observed at 2026-09-10T16:37:53Z. Input: chr17:43104953 G>C.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "chr17:43104953 G>C"
}
}Status: resolved; automated class: VUS.
Keep the automated VUS result separate from individual source assertions and preserve their review states and provenance.
Returned criteria and decision-path annotations: PP3_Supporting [VCEP:ENIGMA BRCA1/2 v1.2.0]. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: available; dosage: available; expert: available; gene_constraints: available; population: available; predictors: available; spliceai: available.
Inspect the current exact variantInterpret rs80357914.
Observed at 2026-09-10T16:38:03Z. Input: rs80357914.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "rs80357914"
}
}Status: ambiguous; no classification.
Show the returned candidates and request an exact allele. Do not select the first candidate or report a classification.
Evidence availability: clinvar: not_reported; conservation: not_reported; dosage: not_reported; expert: not_reported; gene_constraints: not_reported; population: not_reported; predictors: not_reported; spliceai: not_reported.
This is an identity-check example, not a VUS example. Show candidates and require an exact selection.
Interpret NM_007294.3:c.68_69del exactly as written.
Observed at 2026-09-10T16:38:14Z. Input: NM_007294.3:c.68_69del.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "NM_007294.3:c.68_69del"
}
}Status: not_found; no classification.
Report not_found for this transcript version. Do not silently substitute NM_007294.4 or infer an allele.
Evidence availability: clinvar: not_reported; conservation: not_reported; dosage: not_reported; expert: not_reported; gene_constraints: not_reported; population: not_reported; predictors: not_reported; spliceai: not_reported.
This notation missed at capture time. Do not replace a user-supplied transcript or infer an allele.
What evidence is available for rs429358?
Observed at 2026-09-10T16:38:24Z. Input: rs429358.
{
"name": "search_variant_evidence",
"arguments": {
"assembly": "GRCh38",
"query": "rs429358"
}
}Status: resolved; automated class: B.
Report the returned automated B classification and its evidence as a dated variant-level result. It is not a patient risk assessment or reassurance.
Returned criteria and decision-path annotations: BA1,BS2,BP4. Bracketed VCEP and ERepo labels describe provenance; they are not additional ACMG criterion codes.
Evidence availability: clinvar: available; conservation: available; dosage: no_record; expert: no_record; gene_constraints: available; population: available; predictors: available; spliceai: available.
Inspect the current exact variantAlready have a ClinVar, Ensembl or publication record?
Use the exact public HGVS, rsID or verified GRCh38 allele from the record, preserving transcript versions. A gene name, phenotype or paper title alone is not a variant identity. Folklore resolves the supported allele and returns automated classification with available evidence and provenance.
Read submitted ClinVar assertions separately from the automated classification. When publications are requested, use the verified identity for variant literature search; a paper association does not establish pathogenicity. Missing evidence and ambiguous identities remain explicit.
Step-by-step agent flow
Call search_variant_evidence with GRCh38 and the public expression. Continue only if the result is resolved.
- Record normalized coordinates, alleles, gene, transcript and canonical key.
- Report the current automated classification and applied criteria.
- Group available evidence by source and preserve data versions.
- Use the canonical key for variant literature when requested.
- Inspect individual PMIDs only after they are returned by literature search.
- End with limitations and qualified professional review.
Identity checks with public examples
For a BRCA1 example, the verified public GRCh38 identity GRCh38:chr17:43124027:ACT:A resolves to BRCA1 ENST00000357654.9:c.68_69del. A separate non-BRCA example, ENST00000226413.5:c.317A>G, resolves to GNRHR. These examples show why a gene name or familiar short form must not replace exact allele and transcript verification.
- Preserve the transcript accession and version supplied by the user.
- If that transcript expression does not resolve, report the state instead of substituting a different transcript.
- Treat GRCh37 input as outside the current GRCh38 contract unless the user supplies a separately verified GRCh38 representation.
- Report structural variants and other unsupported variant types as unsupported.
- Read snapshot dates and versions; run a new query for the current classification.
Branch before you summarize
For an ambiguous result, show candidates and ask the user to choose. For not_found, invalid_request, unsupported or resolution_unavailable states, report the state directly. Never substitute a likely variant or a model-memory classification.
Public scientific boundary
Folklore Clinical Variant Interpretation MCP accepts public gene, disease and single-variant queries. Do not send patient, phenotype, family, segregation or private case data. Results are automated decision support for qualified professional review, not a diagnosis or treatment recommendation.
Using Folklore with your laboratory or research team?
Introduce your team if you would like help connecting your agents or a conversation about working together.
Introduce your teamOptional. Public variant interpretation remains available without an introduction.