folklore-variant-evidence

Folklore Variant Evidence

Use Folklore Clinical Variant Interpretation MCP to retrieve structured public variant evidence, automated variant-level ACMG/AMP decision support, provenance, and source-linked literature for professional review. Keep the workflow limited to public identifiers and preserve every explicit outcome state. Adapter 1.5.0 also provides ClinGen Gene-Disease Validity assertions; source coverage is bounded, not every known association.

Folklore Clinical Variant Interpretation MCP is published by Helena Bioinformatics. Its hosted endpoint is:

https://api.helena.bio/folklore/v1/mcp

No account or API key is required. The public Apache-2.0 adapter and contract are available at https://github.com/helena-bioinformatics/folklore-mcp.

Minimal connection example

A host without native MCP support can make the same public JSON-RPC call:

curl --silent --show-error --fail-with-body --max-time 60 \
  -X POST https://api.helena.bio/folklore/v1/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: tools/call' \
  -H 'Mcp-Name: search_variant_evidence' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}},"name":"search_variant_evidence","arguments":{"assembly":"GRCh38","query":"rs80357914"}}}'

Inspect the returned outcome before continuing. This example can return ambiguous with multiple candidates: stop and request an unambiguous public variant notation instead of selecting a candidate automatically.

Select the right skill

Use this skill when the task is one public variant to structured Folklore evidence, explicit resolution-state handling, variant-linked literature, or ClinGen gene-to-disease/disease-to-gene assertions.

• Use database-lookup for broad direct queries across ClinVar, dbSNP, gnomAD, Ensembl VEP, COSMIC, or multiple databases.
• Use genomic-coordinates first when the assembly, coordinate convention, contig name, or variant representation is uncertain.
• Do not use this skill for VCF annotation, batch processing, somatic variants, structural variants, polygenic scores, or patient-specific interpretation.