Folklore

Descripción

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.

Qué puedes hacer

• 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

Herramientas 11

• search_variant_evidenceSolo lectura

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

• search_variant_literatureSolo lectura

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

• get_publication_detailsSolo lectura

  Get the full bibliographic record and abstract for one PMID.

• search_literature_corpusSolo lectura

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

• support_helenaSolo lectura

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

• get_gene_disease_associationsSolo lectura

  Find ClinGen gene-disease validity assertions for one gene.

• search_disease_genesSolo lectura

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

• resolve_geneSolo lectura

  Resolve a gene symbol, alias or stable identifier

• get_gene_profileSolo lectura

  Read the complete public gene evidence profile

• get_gene_sectionSolo lectura

  Read a page of source-qualified gene evidence

• search_gene_literatureSolo lectura

  Find live literature for a resolved public gene

Leídas del servidor en funcionamiento el 31 oct 2026. Solo lectura, Escritura y Puede borrar son indicaciones que declara el servidor; tu cliente decide si te pregunta antes de ejecutar una herramienta.

Prompts de ejemplo

• 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

Configuración

Todos los clientes se conectan a api.helena.bio. Elige el tuyo; la página recuerda tu elección.

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

Insertar

Muestra Folklore en un README o en tu web. Cada inserción enlaza a esta página, usa la URL propia del servidor y no instala cookies. Cómo funcionan las inserciones

La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.

Insignia para README Tarjeta para web iframe JSON Prompt para la IA

Insignia para 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>

Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.

Tarjeta para web

HTML

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

La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala 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>

Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.

JSON

La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, la URL propia del servidor, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).

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

Qué significa cada campo

Prompt para la IA

Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de Folklore a tu web.

Markdown

Añade a mi web la tarjeta de mcp.tc de Folklore, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.

Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:

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

Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.

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

Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.

Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).

Para un README u otra documentación en Markdown, usa la insignia:

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

Referencia: https://mcp.tc/es/embed

Historial de cambios

Leemos la lista de herramientas de este servidor cada 3 horas y registramos lo que cambia. Última lectura: 31 oct 2026, 08:46 UTC.

1. 30 oct 2026, 20:48 UTC, Comprobación automática

   Nueva versión 1.6.0 (antes 1.5.0). Declarada por el servidor.

2. 30 oct 2026, 20:48 UTC, Comprobación automática

   4 herramientas añadidas. Instrucciones del servidor cambiadas.

   Nuevas instrucciones del servidor

   Detalles, 30 oct 2026, 20:48 UTC

   Añadidas 4

   • get_gene_profileSolo lectura

     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_sectionSolo lectura

     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_geneSolo lectura

     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_literatureSolo lectura

     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.

   Instrucciones del servidor

   Antes

   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.

   Despué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, Comprobación automática

   Inicio del seguimiento: 7 herramientas.

Preguntas frecuentes