Folklore

Descrizione

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.

Cosa puoi fare

• 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

Tool 11

• search_variant_evidenceSola lettura

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

• search_variant_literatureSola lettura

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

• get_publication_detailsSola lettura

  Get the full bibliographic record and abstract for one PMID.

• search_literature_corpusSola lettura

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

• support_helenaSola lettura

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

• get_gene_disease_associationsSola lettura

  Find ClinGen gene-disease validity assertions for one gene.

• search_disease_genesSola lettura

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

• resolve_geneSola lettura

  Resolve a gene symbol, alias or stable identifier

• get_gene_profileSola lettura

  Read the complete public gene evidence profile

• get_gene_sectionSola lettura

  Read a page of source-qualified gene evidence

• search_gene_literatureSola lettura

  Find live literature for a resolved public gene

Letti dal server attivo (31 ott 2026). Sola lettura, Scrive e Può eliminare sono indicazioni dichiarate dal server; è il tuo client a decidere se chiederti conferma prima di eseguire un tool.

Prompt di esempio

• 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

Configurazione

Ogni client si collega a api.helena.bio. Scegli il tuo; la pagina ricorda la tua scelta.

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

Embed

Mostra Folklore in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa l’URL del server stesso e non imposta cookie. Come funzionano gli embed

Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.

Badge per il README Card per il sito iframe JSON Prompt per l’AI

Badge per il 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>

Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.

Card per il sito

HTML

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

La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta 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>

Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.

JSON

La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, URL del server, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).

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

Cosa significa ogni campo

Prompt per l’AI

Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di Folklore al tuo sito.

Markdown

Aggiungi al mio sito la card di mcp.tc per Folklore, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.

Metti questo tag dove deve comparire la card. La card appare subito prima del tag:

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

Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.

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

Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.

Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).

Per un README o altra documentazione in Markdown, usa invece il badge:

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

Riferimento: https://mcp.tc/it/embed

Cronologia delle modifiche

Leggiamo l’elenco dei tool di questo server ogni 3 ore e registriamo cosa cambia. Ultima lettura: 31 ott 2026, 08:46 UTC.

1. 30 ott 2026, 20:48 UTC, Controllo automatico

   Nuova versione 1.6.0 (prima 1.5.0). Dichiarata dal server.

2. 30 ott 2026, 20:48 UTC, Controllo automatico

   4 tool aggiunti. Istruzioni del server modificate.

   Nuove istruzioni del server

   Dettagli, 30 ott 2026, 20:48 UTC

   Aggiunti 4

   • get_gene_profileSola lettura

     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_sectionSola lettura

     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_geneSola lettura

     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_literatureSola lettura

     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.

   Istruzioni del server

   Prima

   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.

   Dopo

   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 ott 2026, 11:21 UTC, Controllo automatico

   Inizio del tracciamento: 7 tool.

Domande frequenti