Folklore Clinical Variant Interpretation MCP

io.github.helena-bioinformaticsPublished by GitHub account helena-bioinformaticsv2.0.0Updated Nov 6, 2026

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

The publisher's own server: [PREPROD] Clinical.ly Research Suite

VerifiedStreamable HTTPWeb executableKnowledge & MemoryData & AnalyticsAI & ML

Overview

AI-generated overview

Hosted MCP server for clinical genomics: ACMG/AMP germline variant classification, gene and disease associations, and literature search.

What you can do
  • Resolve and classify one GRCh38 germline SNV or small indel under ACMG/AMP, with criteria, ClinVar assertions and population frequencies
  • Search variant-linked publications, fetch a PMID record, and search a PubMed-derived genetics corpus by question, PMID, DOI, gene, phenotype, HPO or OMIM
  • Resolve human gene symbols and identifiers, then read a gene profile section by section at a fixed snapshot
  • Look up ClinGen gene-disease validity from a gene symbol, HGNC ID, MONDO ID or disease name
  • Retrieve a separate live publication capture for a resolved gene
  • With an API key, run case analysis workflows and read result manifests
When to use it
Useful when an assistant needs to interpret germline variants, check ClinGen gene-disease validity, or pull genetics literature and publication records during research or variant-review work. Public scientific tools work anonymously; case workflows need an account key.
Requirements
A remote Streamable HTTP endpoint; no local server needed. Public tools are anonymous. Case, source and result tools require a Folklore API key sent in the Authorization Bearer header, created in a Folklore account. Processing is governed by that account's subscription limits and credits. Clients sharing egress share one rate budget.
Before you install
The API key is a credential: keep it in the client's secret store, not in prompts, tool arguments or URLs. A key does not grant funded compute; case analysis consumes subscription limits and credits, so set an explicit cost ceiling. Case submissions and downloads write and retrieve data on the account. Variant queries and identifiers are sent to the hosted service.

Installation

In SourceWeft

  1. Open Folklore Clinical Variant Interpretation MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.helena-bioinformatics%2Ffolklore/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Folklore Clinical Variant Interpretation MCP

One hosted MCP server for public scientific queries and authenticated case workflows.

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

Version 2.0.0

[License] [DOI] [OpenSSF Scorecard] [AllMCPs Verified]

Connect your MCP client directly to this Streamable HTTP endpoint. No local Folklore server is required. Anonymous callers receive 11 public tools. Send your Folklore API key in the Authorization Bearer header to access 18 additional case, source and result tools at the same endpoint. Invalid supplied credentials fail authentication; they do not select the anonymous catalog.

Create a key in your Folklore account for the selected account and sources. Keep it in your client's secret store, never in prompts, tool arguments or URLs. The selected account's native subscription capabilities, usage limits and eligible credits govern processing. A key does not grant funded compute.

See case workflows, the 18 authenticated tool schemas and the public task recipes.

Classify a variant

Connect your MCP client to:

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

Access is anonymous. Call classify_germline_variant:

json
{"name":"classify_germline_variant","arguments":{"assembly":"GRCh38","query":"NM_007294.4:c.68_69del"}}

Input: one public GRCh38 nuclear germline SNV or simple indel smaller than 50 bp. Accepted notation includes supported HGVS, SPDI, rsID and genomic coordinates. Preserve transcript versions and reference alleles.

A resolved identity with successful interpretation includes automated ACMG/AMP classification, reported criteria, annotations, source evidence and provenance. Submitted ClinVar assertions retain their own source attribution alongside the Folklore classification. A VUS is a classification outcome.

StatusNext step
resolvedRead interpretation status, then classification and evidence.
ambiguousPresent candidates for an explicit allele choice.
not_foundReport the source-scoped miss.
invalid_requestSupply a corrected supported expression.
unsupportedSelect a workflow for the requested variant type or assembly.
resolution_unavailableInspect the typed error and retry policy.

Interpretation status is success or unavailable. Transport, JSON-RPC, MCP and adapter errors have separate fields. See typed outcomes.

Scientific tools

ToolOperation
classify_germline_variantResolve, classify and assess one supported germline variant.
search_variant_literatureRetrieve publications linked to a resolved variant.
get_publication_detailsRetrieve the bibliographic record and abstract for a PMID.
search_literature_corpusSearch publications by scientific question or public identifier.
get_gene_disease_associationsRetrieve ClinGen assertions for an exact gene symbol or HGNC identifier.
search_disease_genesRetrieve ClinGen assertions by MONDO identifier or disease-name substring.
resolve_geneResolve a human gene symbol, alias or stable identifier.
get_gene_profileRead the selected HGNC gene at its returned snapshot.
get_gene_sectionContinue one profile section using its cursor.
search_gene_literatureRetrieve a separate live publication capture for the selected gene.

ClinGen results preserve assertion-level disease identity, inheritance, validity assessment, panel, date and source links. Profile sections retain provider, assembly, release, units and pagination. Gene literature has its own capture identity. Follow gene-disease and gene-profile contracts for exact inputs.

support_helena provides links to the separate Helena Good service when the user asks about supporting Helena. An optional MCP App renders variant results.

Connect an agent or application

The hosted server uses stateless Streamable HTTP and MCP 2026-07-28. Requests carry matching protocol metadata and routing headers. Supported methods include server/discover, tools/list, tools/call, prompts/list, prompts/get, resources/list and resources/read.

The compatibility guide records protocol/client observations. All clients sharing egress use the same rate budget.

Agent Skill and workflow prompts

Install the portable Agent Skill using the installation guide. It routes pathogenicity, VUS, ClinVar, population-frequency, gene-disease and literature tasks to the hosted tools. The skill source includes OpenAI interface metadata.

Workflow prompts compose tool operations for classification, VUS assessment, ACMG/AMP explanation, identity verification and variant-literature comparison. Each accepts one public variant expression.

Run the adapter

The Apache-2.0 adapter implements MCP transport, public API clients and validated response projection. Folklore's scientific authorities produce normalization, annotation, evidence aggregation and classification.

bash
python3.12 -m venv .venv. .venv/bin/activatepip install -e '.[dev]'FOLKLORE_MCP_ENABLED=true \FOLKLORE_LITERATURE_ENABLED=true \FOLKLORE_GENE_DISEASE_ENABLED=true \FOLKLORE_PUBLIC_GENE_ENABLED=true \folklore-mcp

Capabilities are enabled through the flags above. Gene literature requires both public-gene and literature capabilities. The default upstream is https://api.helena.bio; local contract tests support localhost and 127.0.0.1. The standalone HTTP image uses Dockerfile.adapter; Dockerfile provides the pinned stdio bridge.

Verify and measure

bash
pytestruff check .ruff format --check .python3 ops/reconcile_discovery.py

The read-only reconciler compares runtime, Server Card and Official Registry state, with separate aggregator observations. python3 ops/public_smoke.py checks discovery, prompts and resources.

Public measurement sources: variant interpretation, 100-case agent discovery, 60-query search discovery and genomic discovery cohort.

Registry and citation

The immutable MCP adapter 1.6.0 archive is 10.5281/zenodo.23817704, from signed tag folklore-mcp-v1.6.0 at 55a332c6dd6bd4650e921c12ac145b8e0f90476a. The Biorouter-tag archive is 10.5281/zenodo.23818207.

License

Apache License 2.0. See LICENSE and NOTICE.

Automated variant classifications support qualified professional review and are not patient diagnoses or treatment recommendations.

Source: README.md at commit d5cdae4

Tools

11

classify_germline_variant

Classify or interpret a germline variant under ACMG/AMP

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.

Parametersqueryrequiredassembly

search_variant_literature

Find literature for a germline variant

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.

Parameterslimitqueryrequiredassemblyquestion

get_publication_details

Get details for a PubMed publication

Retrieve one PMID from the PubMed-derived genetics corpus, including title, abstract, authors, journal, publication types, MeSH terms, gene and variant mentions, retraction status and PubMed/PMC links.

Parameterspmidrequired

search_literature_corpus

Search the Folklore Literature Corpus

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.

Parameterssortlimitqueryrequiredcursor

support_helena

Support Helena's free scientific infrastructure

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

Takes no parameters.

get_gene_disease_associations

Find diseases associated with a gene

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.

Parametersgenerequiredlimitoffset

search_disease_genes

Find genes associated with a disease

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.

Parameterslimitoffsetdiseaserequired

resolve_gene

Resolve a gene symbol, alias or stable identifier

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.

Parametersqueryrequired

get_gene_profile

Read the complete gene profile

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.

Parametersgene_idrequiredsnapshot_idrequired

get_gene_section

Read a page of gene records

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.

Parameterslimitcursorgene_idrequiredsectionrequiredsnapshot_idrequired

search_gene_literature

Find live literature for a resolved public gene

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.

Parameterssortlimitcursorgene_idrequiredsnapshot_idrequired

Version history

4
  1. v2.0.0LatestNov 6, 2026
  2. v1.7.0Nov 1, 2026
  3. v1.6.0Oct 30, 2026
  4. v1.5.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Clinical integrations

[PREPROD] Clinical.ly Research Suite

ly.clinical.api-preprodOfficial publisher

[PREPROD] Clinical.ly Research Suite's hosted MCP server, published by api-preprod.clinical.ly; credential required; Streamable HTTP.

Streamable HTTPWeb executableAuth
Credential requiredNov 4, 2026

Pharma, FDA & ClinicalTrials.gov Intelligence MCP

Published by GitHub account willowswt

Remote MCP server that lets an assistant search ClinicalTrials.gov trials, OpenFDA safety and recall data, and PubMed evidence in compact, citation-ready form.

Streamable HTTPWeb executableAuth
FinanceCredential requiredNov 19, 2026

ClinicalTrials.gov Scraper: clinical trial studies and results

Published by GitHub account bepolabs

An Apify-hosted MCP server that lets an assistant retrieve ClinicalTrials.gov clinical trial studies and results through one tool.

Streamable HTTPWeb executableAuth
Web Search & ScrapingCredential requiredNov 12, 2026

Zovo Trial Finder

Published by GitHub account theluckystrike

A remote MCP server that lets an assistant find recruiting clinical trials for a condition, optionally near a city, and pull details of a specific study.

Streamable HTTPWeb executable
Location & Lifestyle2 toolsNov 8, 2026

HealthStylz Clinical Nutrition & Circadian Environment MCP

Published by GitHub account harrybuild

A remote HealthStylz server that gives an assistant wellness content: dietitian articles, supplement evidence, herb and curtain guides, and nutrition…

Streamable HTTPWeb executable
Location & Lifestyle8 toolsNov 11, 2026