Skip to main content
Glama

Folklore Clinical Variant Interpretation MCP

Server Details

Germline ACMG/AMP classification, genes, disease associations, literature and API-key case analysis.

Ownership verified
Status
Healthy
Uptime
95.7% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
helena-bioinformatics/folklore-mcp
GitHub Stars
1
Server Listing
Folklore Clinical Variant Interpretation MCP
ChatGPT
–
Claude
–

TDQS

A3.7/5.0

Scored across 11 tools

Disambiguation4/5

Most tools have clearly distinct targets (gene resolution, gene profile, gene sections, variant classification, publication lookup), and descriptions explicitly steer between the three literature tools (variant-anchored, live gene capture, general corpus). Minor overlap remains: get_gene_disease_associations and search_disease_genes are inverse queries returning the same ClinGen assertions, gene-profile sections duplicate some association data, and support_helena is unrelated to the clinical workflow.

Naming Consistency4/5

All names are snake_case with a verb_noun structure (classify_*, get_*, resolve_*, search_*), which is highly predictable. The only deviations are the noun-heavy support_helena and the subtle semantic difference between get_gene_disease_associations and search_disease_genes, which use different verbs for closely related retrieval.

Tool Count4/5

Eleven tools is a well-scoped surface for a variant-interpretation server: resolution, profile paging, classification, and literature retrieval each earn their place. support_helena is out-of-domain but only one tool, so it barely dilutes the set.

Completeness4/5

The core lifecycle is covered end to end: gene resolution to profile/sections, gene-disease validity in both directions, germline variant classification with ClinVar and population data, plus publication and corpus literature retrieval. Gaps exist for structural/CNV interpretation (<50 bp only), phenotype/HPO-driven gene triage, and any batch or VCF-level workflow.

Available Tools

11 tools
classify_germline_variantClassify or interpret a germline variant under ACMG/AMPA
Read-onlyIdempotent
Inspect

Classify one GRCh38 germline nuclear SNV or simple indel smaller than 50 bp under ACMG/AMP. Accepts genomic, coding or protein HGVS, coordinates, SPDI, rsID or a returned canonical key. Returns normalized identity, automated classification, applied criteria, ClinVar assertions, population frequencies, annotations and source provenance when available. Ambiguous input returns candidates for selection.

Inputs: query (required), assembly. Returns: result, record_url, adapter_error, contract_version

get_gene_disease_associationsFind diseases associated with a geneA
Read-onlyIdempotent
Inspect

Find diseases associated with an exact gene symbol or HGNC identifier. Returns ClinGen gene-disease validity assertions, relation-specific inheritance, source reports and snapshot provenance, including conflicting and limited assertions.

Inputs: gene (required), limit, offset. Returns: object

get_gene_profileRead the complete gene profileA
Read-onlyIdempotent
Inspect

Read the selected gene_id and immutable snapshot_id from resolve_gene. Returns overview, disease validity, dosage, mechanisms, transcripts, native assemblies, constraint, ClinVar summaries and consequences, expression, GWAS, phenotypes and protein/pathways with source assertions, coverage, count units and null values. get_gene_section supplies further pages. Live search_gene_literature is separate from the snapshot literature section.

Inputs: gene_id (required), snapshot_id (required). Returns: result, record_url, adapter_error, contract_version

get_gene_sectionRead a page of gene recordsA
Read-onlyIdempotent
Inspect

Read a gene-profile section using gene_id, snapshot_id and its returned opaque cursor. Returns source records, assembly/release, coverage, totals, count units and provenance. snapshot_unavailable requires a fresh resolution/profile request.

Inputs: gene_id (required), section (required), snapshot_id (required), limit, +1 more. Returns: result, record_url, adapter_error, contract_version

get_publication_detailsGet details for a PubMed publicationA
Read-onlyIdempotent
Inspect

Retrieve one publication from Folklore's PubMed-derived genetics corpus, including title, abstract, authors, journal, publication types, MeSH terms, gene and variant mentions, retraction status and PubMed/PMC links. Pass exactly {"pmid":"12345678"}, using a PMID returned by search_variant_literature or search_literature_corpus. The pmid must be a string of 1 to 12 ASCII digits, not a number, URL, DOI or PMID-prefixed label. This is a corpus lookup, not a lookup of every PubMed record. On publication_not_found, do not retry the same PMID; search_literature_corpus can find available records.

Inputs: pmid (required). Returns: object

resolve_geneResolve a gene symbol, alias or stable identifierA
Read-onlyIdempotent
Inspect

Resolve a human gene symbol, previous symbol, alias, HGNC, Ensembl or NCBI Gene identifier. Returns exact, alias, ambiguous, not_found or withdrawn status with candidates and identity_snapshot_id. Use a selected HGNC gene_id and snapshot_id with get_gene_profile. Gene-plus-HGVS and variant expressions use classify_germline_variant.

Inputs: query (required). Returns: result, record_url, adapter_error, contract_version

search_disease_genesFind genes associated with a diseaseA
Read-onlyIdempotent
Inspect

Find genes associated with an exact MONDO identifier or disease-name search. Returns ClinGen validity assertions with inheritance, source reports and snapshot provenance. Name searches can return multiple disease identities.

Inputs: disease (required), limit, offset. Returns: object

search_gene_literatureFind live literature for a resolved public geneA
Read-onlyIdempotent
Inspect

Retrieve a live publication capture for a resolved gene_id and snapshot_id. Returns source links, match labels, capture time/hash, degradation and gene/snapshot/sort-bound cursors. This capture is separate from the immutable reference snapshot and contains no abstracts.

Inputs: gene_id (required), snapshot_id (required), sort, limit, +1 more. Returns: result, record_url, adapter_error, contract_version

search_literature_corpusSearch the Folklore Literature CorpusA
Read-onlyIdempotent
Inspect

Search the genetics Literature Corpus by question, PMID, DOI, PMCID, gene, variant, phenotype, HPO or OMIM concept. Known publication identifiers provide exact anchors. Returns ranked publications, match types, scores and source links.

Inputs: query (required), sort, limit, cursor. Returns: object

search_variant_literatureFind literature for a germline variantA
Read-onlyIdempotent
Inspect

Resolve one GRCh38 germline variant and retrieve publications from the PubMed-derived genetics corpus. Exact variant mentions rank ahead of broader gene associations. Returns match types, source links, corpus provenance and retrieval time.

Inputs: query (required), limit, assembly, question. Returns: object

support_helenaSupport Helena's free scientific infrastructureB
Read-onlyIdempotent
Inspect

Retrieve Helena Good campaign, rules, manifest and MCP connection URLs.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables real-time pharmacogenomics analysis, including variant clinical significance, drug-gene interactions, and dosing guidelines, by connecting to ClinVar, PharmGKB, gnomAD, and other databases.
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Agent-callable canine genomics API providing breed-stratified allele frequencies, pathogenicity predictions, and variant-gene-breed-disease knowledge graph for dog DNA.
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching cancer genes and curated variants from CIViC, retrieving associated diseases, therapies, and graded evidence items and assertions for clinical interpretation.
      58 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.