Documentation / Folklore Clinical Variant Interpretation MCP Connector
Folklore Clinical Variant Interpretation MCP Connector
Classify and interpret a supported GRCh38 germline variant under ACMG/AMP using structured variant evidence, provenance and related scientific literature. Folklore Clinical Variant Interpretation MCP is the official free, public, read-only remote interface from Helena Bioinformatics and requires no account or API key. The public interface accepts public gene, disease and single-variant queries. Patient, phenotype, family, segregation and private case data remain excluded. Results support qualified professional review and are not a diagnosis or treatment recommendation.
Gene-disease evidence for genomic analysis
Folklore is a bioinformatics MCP for the evidence and interpretation steps of human genomic analysis, including downstream WGS and WES workflows. It does not parse DNA sequences or VCF files, run variant calling, or accept batch or patient datasets.
Ask which genes have curated evidence for Marfan syndrome with search_disease_genes, or which diseases are associated with FBN1 using get_gene_disease_associations. Use the returned local source snapshot version and hash for reproducibility; this does not guarantee the latest ClinGen release. Initial source coverage is ClinGen gene-disease validity assertions. Preserve each relationship, inheritance mode, validity assessment, source report and evaluation date.
Gene-disease validity is separate from variant ACMG/AMP classification. Keep distinct disease matches separate; a missing record does not establish absence of an association.
Genomic analysis workflows and complete request examplesConnection details
Protocol: Model Context Protocol over Streamable HTTP
Endpoint: https://api.helena.bio/folklore/v1/mcp
Tools: search_variant_evidence, search_variant_literature, get_publication_details, search_literature_corpus, get_gene_disease_associations, search_disease_genes
Workflow prompts: classify_germline_variant, review_vus_evidence, explain_acmg_classification, verify_variant_identity, compare_variant_literature
Authentication: None
Operations: Public and read-only
Clients and directories: Folklore integrations
Search the Literature Corpus
Use search_literature_corpus for bounded scientific-literature questions. Natural-language queries can include known PMID, DOI or PMCID identifiers as exact anchors, as well as genes, variants, phenotypes, HPO and OMIM concepts. Results include source links, match types, article entities, pagination state and an explicit signal when semantic retrieval is degraded.
These results are evidence candidates for professional review. They do not establish causality, change a Folklore classification or provide a patient diagnosis or treatment recommendation.
Ask about a variant
Add the endpoint as a custom remote connector in an MCP-compatible client. A Folklore account and API key are not required. The public tool accepts GRCh38 chromosome coordinates, genomic or coding HGVS, protein HGVS, SPDI and rsID.
Example request
Use Folklore to classify ENST00000226413.5:c.317A>G under ACMG/AMP and summarize the evidence, provenance and limitations.
The current public scope covers nuclear germline SNVs and simple insertions or deletions shorter than 50 base pairs. Queries use GRCh38. GRCh37, mitochondrial, structural and somatic variants return an unsupported result.
What comes back
A resolved result contains the GRCh38 identity, current annotation, automated ACMG/AMP decision-support classification, applied evidence, ClinVar assertions, population frequency and computational predictions when available. It also records source provenance, data versions, limitations and a link to the matching public Folklore record.
The response status is resolved, ambiguous, not found, invalid, unsupported or temporarily unavailable. The request contract contains only the assembly and variant expression. Patient, phenotype, family, segregation and case information are outside this public service.
Clinical use
Folklore provides variant-level decision support for qualified genetics professionals. Its automated classification does not establish a patient diagnosis or determine treatment. A qualified professional must review the evidence and confirm clinically significant findings before they enter a clinical report or patient-care decision.
Review the platform limitations, classification methodology, Privacy Policy and Terms of Service before clinical use.
Cite the public adapter
The standalone Apache-2.0 MCP adapter is archived separately from the proprietary Folklore SaaS platform. Use the all-version DOI for a durable link to the latest archived adapter release, or cite the exact version 1.3.1 software release as doi:10.5281/zenodo.22093164.