Folklore

Über den Server

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.

Was du damit machen kannst

• 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

Tools 11

• search_variant_evidenceLiest nur

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

• search_variant_literatureLiest nur

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

• get_publication_detailsLiest nur

  Get the full bibliographic record and abstract for one PMID.

• search_literature_corpusLiest nur

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

• support_helenaLiest nur

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

• get_gene_disease_associationsLiest nur

  Find ClinGen gene-disease validity assertions for one gene.

• search_disease_genesLiest nur

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

• resolve_geneLiest nur

  Resolve a gene symbol, alias or stable identifier

• get_gene_profileLiest nur

  Read the complete public gene evidence profile

• get_gene_sectionLiest nur

  Read a page of source-qualified gene evidence

• search_gene_literatureLiest nur

  Find live literature for a resolved public gene

Am 31. Okt. 2026 vom laufenden Server gelesen. „Liest nur“, „Schreibt“ und „Kann löschen“ sind Hinweise, die der Server selbst angibt; dein Client entscheidet, ob er vor dem Ausführen eines Tools nachfragt.

Beispiel-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

Einrichtung

Jeder Client verbindet sich mit api.helena.bio. Wähl deinen; die Seite merkt sich deine Wahl.

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"
    }
  }
}

Einbinden

Zeig Folklore in einem README oder auf deiner Website. Jede Einbindung verlinkt auf diese Seite, nutzt die eigene URL des Servers und setzt keine Cookies. So funktionieren Einbindungen

Karte, iframe und JSON sind auf Englisch. Häng ?lang=it, fr, de oder es an ihre Adresse an, um eine andere Sprache zu bekommen.

README-Badge Website-Karte iframe JSON KI-Prompt

README-Badge

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>

Es folgt dem hellen oder dunklen Modus der Lesenden. Hänge ?theme=light oder ?theme=dark an, um ihn festzulegen, oder ?style=compact, um das Zeichen ohne Schriftzug zu zeigen.

Website-Karte

HTML

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

Die Karte erscheint dort, wo das Tag steht. Füge dem Tag data-theme="dark" oder data-size="compact" hinzu, um sie zu ändern. Die Datei enthält alles, was sie braucht, stellt also keine weiteren Anfragen und setzt keine Cookies.

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>

Nutze es auf Seiten, die keine Skripte erlauben. Hänge ?theme=light oder ?theme=dark an die Adresse an, um die Farben festzulegen.

JSON

Der Eintrag als Daten für deine eigenen Seiten und Tools: Name, Kurzbeschreibung, die eigene URL des Servers, Tools und die „Add to“-Links. Jede Website kann ihn lesen (CORS ist offen).

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

Was jedes Feld bedeutet

KI-Prompt

Füg ihn in einen KI-Coding-Assistenten wie Claude Code oder Cursor ein, und er baut die Karte von Folklore in deine Website ein.

Markdown

Füge meiner Website die mcp.tc-Karte für den MCP-Server Folklore hinzu. Es ist ein einziges statisches Skript: kein Build-Schritt, kein Paket zu installieren, keine Cookies.

Setz dieses Tag dorthin, wo die Karte erscheinen soll. Die Karte erscheint direkt davor:

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

Um sie woanders zu zeigen, setz dort diesen Platzhalter ein und lade dasselbe Skript nur einmal, zum Beispiel vor `</body>`. Lass den Link darin stehen: Besucher ohne JavaScript sehen ihn.

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

Optionen:
- `data-theme="light"` oder `"dark"` am Tag oder Platzhalter legt die Farben fest. Ohne das Attribut folgt die Karte dem hellen oder dunklen Modus der Besucher.
- `data-size="compact"` ergibt eine kleinere Karte ohne Kurzbeschreibung.
- Die CSS-Variable `--mcptc-max-width` am Platzhalter oder einem Elternelement legt die Breite fest (Standard `520px`).
- `?lang=` in der Skript-URL legt die Sprache der Karte fest: `en`, `it`, `fr`, `de` oder `es`.

Wenn die Website eine Content Security Policy hat, erlaube `script-src https://mcp.tc` und `img-src data:` (das Icon ist eingebettet).

Für ein README oder andere Markdown-Dokumentation nimm stattdessen das Badge:

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

Referenz: https://mcp.tc/de/embed

Änderungsverlauf

Wir lesen die Tool-Liste dieses Servers alle 3 Stunden und halten fest, was sich ändert. Zuletzt gelesen: 31. Okt. 2026, 08:46 UTC.

1. 30. Okt. 2026, 20:48 UTC, Automatische Prüfung

   Neue Version 1.6.0 (vorher 1.5.0). Vom Server gemeldet.

2. 30. Okt. 2026, 20:48 UTC, Automatische Prüfung

   4 Tools hinzugefügt. Server-Anweisungen geändert.

   Neue Server-Anweisungen

   Details, 30. Okt. 2026, 20:48 UTC

   Hinzugefügt 4

   • get_gene_profileLiest nur

     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_sectionLiest nur

     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_geneLiest nur

     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_literatureLiest nur

     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.

   Server-Anweisungen

   Vorher

   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.

   Nachher

   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. Okt. 2026, 11:21 UTC, Automatische Prüfung

   Beginn der Beobachtung: 7 Tools.

Häufige Fragen