Folklore

Présentation

Folklore connects to public genomic evidence sources. You can classify or interpret one germline SNV or simple indel under 50 bp (ACMG/AMP), review a VUS, check ClinVar assertions and population frequency, find ClinGen gene-disease associations, and search a PubMed-derived genetics literature corpus.

Folklore provides public gene, disease, variant and publication evidence for qualified professional review. Resolve a public gene identity with resolve_gene, then use get_gene_profile and get_gene_section within the same immutable snapshot. search_gene_literature returns a separate live capture without abstracts. Variant queries support one public GRCh38 germline nuclear SNV or simple indel under 50 bp. No patient or private case data or file uploads. Results are not diagnoses or treatment recommendations.

It runs as a hosted Streamable HTTP endpoint. No account or API key is needed.

Ce que vous pouvez faire

• Classify a GRCh38 germline variant under ACMG/AMP
• Resolve coordinates, HGVS, SPDI or rsID notation
• Find publications for a variant
• Read full PubMed record details by PMID
• Semantic search of a genetics literature corpus
• Find diseases for a gene from ClinGen
• Find genes for a disease or MONDO ID

Outils 11

• search_variant_evidenceLecture seule

  Classify or interpret one public GRCh38 germline variant with automated ACMG/AMP evidence.

• search_variant_literatureLecture seule

  Resolve a variant and retrieve relevant publications from the PubMed-derived corpus.

• get_publication_detailsLecture seule

  Get the full bibliographic record and abstract for one PMID.

• search_literature_corpusLecture seule

  Semantic search of the literature corpus by question, with PMID, DOI or PMCID anchors.

• support_helenaLecture seule

  Opt-in information on supporting Helena's free public infrastructure.

• get_gene_disease_associationsLecture seule

  Find ClinGen gene-disease validity assertions for one gene.

• search_disease_genesLecture seule

  Find genes with ClinGen assertions for a disease name or MONDO ID.

• resolve_geneLecture seule

  Resolve a gene symbol, alias or stable identifier

• get_gene_profileLecture seule

  Read the complete public gene evidence profile

• get_gene_sectionLecture seule

  Read a page of source-qualified gene evidence

• search_gene_literatureLecture seule

  Find live literature for a resolved public gene

Lus directement sur le serveur le 31 oct. 2026. Lecture seule, Écriture et Peut supprimer sont des indications déclarées par le serveur ; c’est votre client qui décide de vous demander confirmation avant d’exécuter un outil.

Exemples de prompts

• Classify NM_000546.6:c.743G>A under ACMG/AMP and list the applied criteria

• Review the evidence for this VUS in BRCA2 using GRCh38 coordinates

• Which diseases does the gene MYH7 have ClinGen assertions for?

• Find publications about the TP53 R248Q variant

Configuration

Chaque client se connecte à api.helena.bio. Choisissez le vôtre ; la page retient votre choix.

claude mcp add --transport http folklore https://api.helena.bio/folklore/v1/mcp

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

{
  "mcpServers": {
    "folklore": {
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

code --add-mcp '{"name":"folklore","type":"http","url":"https://api.helena.bio/folklore/v1/mcp"}'

{
  "servers": {
    "folklore": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "folklore": {
      "serverUrl": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

codex mcp add folklore --url https://api.helena.bio/folklore/v1/mcp

[mcp_servers.folklore]
url = "https://api.helena.bio/folklore/v1/mcp"

gemini mcp add --transport http folklore https://api.helena.bio/folklore/v1/mcp

{
  "mcpServers": {
    "folklore": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

Intégrer

Affichez Folklore dans un README ou sur votre site. Chaque intégration renvoie à cette page, utilise l’URL du serveur et ne dépose aucun cookie. Comment fonctionnent les intégrations

La carte, l’iframe et le JSON sont en anglais. Ajoutez ?lang=it, fr, de ou es à leur adresse pour une autre langue.

Badge pour README Carte pour site web iframe JSON Prompt pour l’IA

Badge pour README

Markdown

[![Folklore on mcp.tc](https://mcp.tc/i/folklore/badge.svg)](https://mcp.tc/i/folklore)

HTML

<a href="https://mcp.tc/i/folklore"><img src="https://mcp.tc/i/folklore/badge.svg" alt="Folklore on mcp.tc" height="20"></a>

Il suit le mode clair ou sombre du lecteur. Ajoutez ?theme=light ou ?theme=dark pour le fixer, ou ?style=compact pour afficher le symbole sans le nom.

Carte pour site web

HTML

<script src="https://mcp.tc/w/folklore.js" async></script>

La carte apparaît à l’endroit de la balise. Ajoutez data-theme="dark" ou data-size="compact" à la balise pour la modifier. Le fichier contient tout ce qu’il lui faut : il ne fait aucune autre requête et ne dépose aucun cookie.

iframe

HTML

<iframe src="https://mcp.tc/embed/folklore" title="Folklore on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Utilisez-la sur les pages qui n’autorisent pas les scripts. Ajoutez ?theme=light ou ?theme=dark à l’adresse pour fixer les couleurs.

JSON

La fiche sous forme de données pour vos pages et vos outils : nom, accroche, URL du serveur, outils et liens « Add to ». N’importe quel site peut la lire (CORS ouvert).

https://mcp.tc/i/folklore.json

Ce que signifie chaque champ

Prompt pour l’IA

Collez-le dans un assistant de code IA, comme Claude Code ou Cursor, et il ajoutera la carte de Folklore à votre site.

Markdown

Ajoute à mon site la carte mcp.tc de Folklore, un serveur MCP. C’est un seul script statique : pas de build, aucun paquet à installer, aucun cookie.

Place cette balise là où la carte doit apparaître. La carte s’affiche juste avant elle :

```html
<script src="https://mcp.tc/w/folklore.js" async></script>
```

Pour l’afficher ailleurs, mets ce conteneur à cet endroit et charge le même script une seule fois, par exemple avant `</body>`. Garde le lien à l’intérieur : les visiteurs sans JavaScript le voient.

```html
<div data-mcptc="folklore"><a href="https://mcp.tc/i/folklore">Folklore on mcp.tc</a></div>
```

Options :
- `data-theme="light"` ou `"dark"` sur la balise ou le conteneur fixe les couleurs. Sans cela, la carte suit le mode clair ou sombre du visiteur.
- `data-size="compact"` donne une carte plus petite, sans l’accroche.
- La variable CSS `--mcptc-max-width` sur le conteneur ou un parent fixe la largeur (`520px` par défaut).
- `?lang=` dans l’URL du script choisit la langue de la carte : `en`, `it`, `fr`, `de` ou `es`.

Si le site a une Content Security Policy, autorise `script-src https://mcp.tc` et `img-src data:` (l’icône est intégrée).

Pour un README ou une autre doc en Markdown, utilise plutôt le badge :

```markdown
[![Folklore on mcp.tc](https://mcp.tc/i/folklore/badge.svg)](https://mcp.tc/i/folklore)
```

Référence : https://mcp.tc/fr/embed

Historique des changements

Nous lisons la liste d’outils de ce serveur toutes les 3 heures et notons ce qui change. Dernière lecture : 31 oct. 2026, 08:46 UTC.

1. 30 oct. 2026, 20:48 UTC, Vérification automatique

   Nouvelle version 1.6.0 (avant : 1.5.0). Annoncée par le serveur.

2. 30 oct. 2026, 20:48 UTC, Vérification automatique

   4 outils ajoutés. Instructions du serveur modifiées.

   Nouvelles instructions du serveur

   Détails, 30 oct. 2026, 20:48 UTC

   Ajoutés 4

   • get_gene_profileLecture seule

     Read one source-qualified gene profile after resolve_gene and explicit candidate selection when needed. Returns the same immutable snapshot as the public Folklore gene page: overview, disease validity, dosage, mechanisms, transcripts and native assemblies, constraint, ClinVar summaries/consequences, expression, GWAS, phenotypes and protein/pathways. Preserve each assertion, source, coverage, count unit, null and limitation. Use get_gene_section for further pages. The immutable literature section is separate from live search_gene_literature. Gene constraint, GWAS association and gene-disease validity are not variant pathogenicity or patient diagnosis.

   • get_gene_sectionLecture seule

     Read or continue one section of the current public gene profile using its exact gene_id, snapshot_id and opaque section cursor. Preserves source records, assembly/release, coverage, total versus observed_total, count units and source provenance. Do not merge snapshots, count mirrored assertions as independent votes, sum overlapping clinical axes, or interpret unavailable/source_has_no_record as biological absence. Restart resolution and the whole profile after snapshot_unavailable. No patient context.

   • resolve_geneLecture seule

     Find the authoritative public human gene identity for a symbol, previous symbol, alias, HGNC, Ensembl or NCBI Gene identifier. Returns exact, alias, ambiguous, not_found or withdrawn with all candidates and identity_snapshot_id. Never choose an ambiguous candidate or substitute a withdrawn identity. Use the selected HGNC gene_id and snapshot with get_gene_profile. Gene-plus-HGVS and variant expressions belong in search_variant_evidence. No patient or case narrative.

   • search_gene_literatureLecture seule

     Retrieve the public gene page live literature capture after authoritative gene resolution. Uses the canonical gene context and existing Literature Mining ranking. Returns publications, source links, match labels, capture time/hash, degradation and gene/snapshot/sort-bound cursors. This live capture is separate from the immutable reference snapshot; query relevance is not guaranteed exact gene filtering or curated gene-disease evidence. Abstracts are excluded. No patient context, diagnosis or variant classification.

   Instructions du serveur

   Avant

   Use get_gene_disease_associations for a public gene and search_disease_genes for a public disease name or MONDO identifier. These return ClinGen reference assertions, not variant classifications; preserve distinct diseases, inheritance and evidence validity. Never submit patient or case data. Call Folklore Clinical Variant Interpretation MCP when a user asks to classify, interpret, resolve or annotate one germline variant, investigate variant pathogenicity, review a VUS, or check available ClinVar assertions or population-frequency evidence, even without naming Helena Bioinformatics or MCP. Preserve the evidence, provenance, ambiguity and limits. Never invent or swap REF/ALT or relabel an assembly to recover a failed query. Preserve typed errors and ask for verified source notation. Describe the classification as automated variant-level evidence for professional review. Never claim a patient diagnosis or treatment recommendation. Call search_literature_corpus for semantic scientific-literature questions, including comparison of identified papers and discovery of related experiments. Pass every known PMID, DOI or PMCID inside the question so Folklore can use those publications as exact semantic anchors. Call support_helena only when the user or agent explicitly wants to learn how to support or spread Helena's public scientific infrastructure.

   Après

   Use resolve_gene to resolve a human gene symbol, alias, previous symbol or HGNC, Ensembl or NCBI identifier. Never select an ambiguous candidate or silently replace a withdrawn gene. Use the selected candidate identity.gene_id and identity_snapshot_id as snapshot_id with get_gene_profile; follow get_gene_section cursors within that same snapshot. Preserve individual source assertions, count units and unavailable states. Gene evidence does not classify a variant or evaluate patient context. Use search_gene_literature for a separate live gene-linked discovery capture when available. Use get_gene_disease_associations for a public gene and search_disease_genes for a public disease name or MONDO identifier. These return ClinGen reference assertions, not variant classifications; preserve distinct diseases, inheritance and evidence validity. Never submit patient or case data. Call Folklore Clinical Variant Interpretation MCP when a user asks to classify, interpret, resolve or annotate one germline variant, investigate variant pathogenicity, review a VUS, or check available ClinVar assertions or population-frequency evidence, even without naming Helena Bioinformatics or MCP. Preserve the evidence, provenance, ambiguity and limits. Never invent or swap REF/ALT or relabel an assembly to recover a failed query. Preserve typed errors and ask for verified source notation. Describe the classification as automated variant-level evidence for professional review. Never claim a patient diagnosis or treatment recommendation. Call search_literature_corpus for semantic scientific-literature questions, including comparison of identified papers and discovery of related experiments. Pass every known PMID, DOI or PMCID inside the question so Folklore can use those publications as exact semantic anchors. Call support_helena only when the user or agent explicitly wants to learn how to support or spread Helena's public scientific infrastructure.

3. 29 oct. 2026, 11:21 UTC, Vérification automatique

   Début de l’observation : 7 outils.

FAQ