Server data from the Official MCP Registry
ACMG/AMP germline variant classification, gene profiles, disease associations and literature.
About
ACMG/AMP germline variant classification, gene profiles, disease associations and literature.
Remote endpoints: streamable-http: https://api.helena.bio/folklore/v1/mcp
Security Report
Valid MCP server (1 strong, 0 medium validity signals). 4 known CVEs in dependencies Imported from the Official MCP Registry. Trust signals: trusted author (5/5 approved).
11 tools verified · Open access · 4 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Found in Source Code
Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.
How to Connect
Remote Plugin
No local installation needed. Your AI client connects to the remote endpoint directly.
Add this to your MCP configuration to connect:
{
"mcpServers": {
"io-github-helena-bioinformatics-folklore": {
"url": "https://api.helena.bio/folklore/v1/mcp"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
Folklore Clinical Variant Interpretation MCP
Version 1.7.0
Folklore MCP classifies and assesses germline variants under ACMG/AMP. It returns canonical identity, automated classification, reported criteria, annotation, source evidence and provenance. Gene profiles, ClinGen gene-disease assertions and linked biomedical literature complete the scientific workflow.
Classify a variant
Connect your MCP client to:
https://api.helena.bio/folklore/v1/mcp
Access is anonymous. Call classify_germline_variant:
{"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.
| Status | Next step |
|---|---|
resolved | Read interpretation status, then classification and evidence. |
ambiguous | Present candidates for an explicit allele choice. |
not_found | Report the source-scoped miss. |
invalid_request | Supply a corrected supported expression. |
unsupported | Select a workflow for the requested variant type or assembly. |
resolution_unavailable | Inspect 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
| Tool | Operation |
|---|---|
classify_germline_variant | Resolve, classify and assess one supported germline variant. |
search_variant_literature | Retrieve publications linked to a resolved variant. |
get_publication_details | Retrieve the bibliographic record and abstract for a PMID. |
search_literature_corpus | Search publications by scientific question or public identifier. |
get_gene_disease_associations | Retrieve ClinGen assertions for an exact gene symbol or HGNC identifier. |
search_disease_genes | Retrieve ClinGen assertions by MONDO identifier or disease-name substring. |
resolve_gene | Resolve a human gene symbol, alias or stable identifier. |
get_gene_profile | Read the selected HGNC gene at its returned snapshot. |
get_gene_section | Continue one profile section using its cursor. |
search_gene_literature | Retrieve 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.
- Direct Streamable HTTP
- OpenAI Agents SDK
- Biomni
- Biorouter
- Dify, n8n, Galaxy, KNIME
- Notebook workflow
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.
python3.12 -m venv .venv
. .venv/bin/activate
pip 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
pytest
ruff 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
- Registry name:
io.github.helena-bioinformatics/folklore - Publisher: Helena Bioinformatics
- Website: https://folklore.helena.bio
- Task routing metadata
- Per-tool task contracts
- Security reporting
- Source boundary
- Citation metadata
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.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Rea
Freeby Morluto · Developer Tools
Reverse engineer anything from your terminal or agent with one CLI and MCP server.
Paperclip
Freeby Paperclipai · Developer Tools
Trending hip-hop artist momentum scores across four cultural dimensions.
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Lharries · Communication
Read, search, and send WhatsApp messages through your AI assistant