Documentation / Folklore Clinical Variant Interpretation MCP Connector
Folklore Clinical Variant Interpretation MCP Connector
Folklore Clinical Variant Interpretation MCP is the official public, read-only MCP server from Helena Bioinformatics. It lets an MCP-compatible AI client look up one supported GRCh38 germline variant and return structured Folklore evidence, automated ACMG/AMP decision support, transparent provenance and related scientific literature. It does not provide patient diagnoses or treatment recommendations, and its results require review by a qualified genetics professional.
Connection 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
Authentication: None
Operations: Public and read-only
Clients and directories: Folklore integrations
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.2.2 software release as doi:10.5281/zenodo.21922952.