Directory / Knowledge, memory & context
Folklore Clinical Variant Interpretation MCP
Folklore MCP 2.0.0 provides ACMG/AMP germline variant classification, gene profiles, disease associations and literature through 11 public Streamable HTTP tools. A Folklore Bearer API key enables 18 additional case, approved-source and report tools; setup.
Live Answered an MCP handshake without credentials and listed 11 tools.
- Category
- Knowledge, memory & context
- Transport
http- Source
- https://github.com/helena-bioinformatics/folklore-mcp
- Endpoint
https://api.helena.bio/folklore/v1/mcp- MCP Registry
io.github.helena-bioinformatics/folklore- Reports itself as
- folklore 2.0.0
- Protocol
- 2025-06-18
- Tools
- 11
- Context cost
- about 2,966 tokens for the tool definitions (estimated at four characters per token)
- Tool definitions last changed
- no change seen since first check
- Handshake time
- 488 ms
- Repository
- 1 stars · last push 2026-11-06 · Apache-2.0
- Last checked
- 2026-11-22 11:27:35 UTC
- Listed since
- 2026-11-18
Health and compatibility
| Endpoint reachable | Verified | Responded in 488 ms |
|---|---|---|
| MCP handshake (initialize) | Verified | Completed without credentials |
| Tool discovery (tools/list) | Verified | 11 tools listed |
| Authentication | Verified | None needed to connect |
| Protocol version | Verified | 2025-06-18 |
| Transport | Verified | Streamable HTTP |
| Capabilities declared | Verified | experimental, prompts, resources, tools |
Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.
Recent history
5 daily checks so far; median response 562 ms. Green answered, violet asked for auth, red did not answer.
Set up in your client
Claude Code
Run this in a terminal:
claude mcp add --transport http folklore-clinical-variant-interpretation-mcp https://api.helena.bio/folklore/v1/mcpClaude Desktop
Open Settings → Connectors → Add custom connector and paste this URL:
https://api.helena.bio/folklore/v1/mcpOr bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):
{
"mcpServers": {
"folklore-clinical-variant-interpretation-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://api.helena.bio/folklore/v1/mcp"
]
}
}
}Cursor
Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"folklore-clinical-variant-interpretation-mcp": {
"url": "https://api.helena.bio/folklore/v1/mcp"
}
}
}VS Code
Or add it to .vscode/mcp.json:
{
"servers": {
"folklore-clinical-variant-interpretation-mcp": {
"type": "http",
"url": "https://api.helena.bio/folklore/v1/mcp"
}
}
}Or from a terminal:
code --add-mcp '{"name": "folklore-clinical-variant-interpretation-mcp", "type": "http", "url": "https://api.helena.bio/folklore/v1/mcp"}'Windsurf
Add it to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"folklore-clinical-variant-interpretation-mcp": {
"serverUrl": "https://api.helena.bio/folklore/v1/mcp"
}
}
}Other clients
Most clients accept this shape. The endpoint is:
https://api.helena.bio/folklore/v1/mcp{
"mcpServers": {
"folklore-clinical-variant-interpretation-mcp": {
"type": "http",
"url": "https://api.helena.bio/folklore/v1/mcp"
}
}
}If it does not connect
- Restart the client after editing a config file, and keep keys out of files you commit.
- If the tools do not appear, open the client's MCP log: a 401 means the credentials were not accepted, and a timeout means the server did not answer.
Tools 11
Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON
classify_germline_variantread-onlyClassify one GRCh38 germline nuclear SNV or simple indel smaller than 50 bp under ACMG/AMP. Accepts genomic, …
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.
| Parameter | Type | Description | |
|---|---|---|---|
assembly | string | optional | Reference genome assembly. Folklore currently accepts GRCh38 only. |
query | string | required | One germline nuclear SNV or simple indel to resolve and interpret; accepted forms include coordinates, genomic/coding/protein HGVS, SPDI, rsID, or a returned Folklore canonical_key in GRCh38:chrN:position:REF:ALT form. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "classify_germline_variant",
"arguments": {
"query": "..."
}
}
}get_gene_disease_associationsread-onlyFind diseases associated with an exact gene symbol or HGNC identifier. Returns ClinGen gene-disease validity …
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.
| Parameter | Type | Description | |
|---|---|---|---|
limit | integer | optional | Maximum number of source assertions per page, from 1 to 50. |
offset | integer | optional | Zero-based assertion offset; use the returned nextOffset when present. |
gene | string | required | One public human gene symbol or HGNC identifier, for example BRCA1 or HGNC:1100. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_gene_disease_associations",
"arguments": {
"gene": "..."
}
}
}get_gene_profileread-onlyRead the selected gene_id and immutable snapshot_id from resolve_gene. Returns overview, disease validity, …
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.
| Parameter | Type | Description | |
|---|---|---|---|
gene_id | string | required | Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous. |
snapshot_id | string | required | identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_gene_profile",
"arguments": {
"gene_id": "...",
"snapshot_id": "..."
}
}
}get_gene_sectionread-onlyRead a gene-profile section using gene_id, snapshot_id and its returned opaque cursor. Returns source …
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.
| Parameter | Type | Description | |
|---|---|---|---|
gene_id | string | required | Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous. |
snapshot_id | string | required | identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable. |
section | string | required | Source-qualified section from the current profile. Literature is a separate live capture; use search_gene_literature for it. One of: overview, disease_validity, structure, constraint, dosage, mechanisms, clinical_variants, clinical_variant_consequences … |
limit | integer | optional | Maximum source records per page, from 1 to 50. Counts retain their original source unit. |
cursor | string | null | optional | Opaque next_cursor returned for this same gene, snapshot and section. Omit for its first page. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_gene_section",
"arguments": {
"gene_id": "...",
"snapshot_id": "...",
"section": "overview"
}
}
}get_publication_detailsread-onlyRetrieve one publication from Folklore's PubMed-derived genetics corpus, including title, abstract, authors, …
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.
| Parameter | Type | Description | |
|---|---|---|---|
pmid | string | required | One PMID returned by Folklore literature search, as a JSON string of 1 to 12 ASCII digits. Do not send a number, PMID prefix, URL or DOI. The current corpus does not contain every PubMed record. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_publication_details",
"arguments": {
"pmid": "..."
}
}
}resolve_generead-onlyResolve a human gene symbol, previous symbol, alias, HGNC, Ensembl or NCBI Gene identifier. Returns exact, …
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.
| Parameter | Type | Description | |
|---|---|---|---|
query | string | required | One public gene symbol, previous symbol, alias, HGNC ID, Ensembl gene ID or NCBI Gene ID. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "resolve_gene",
"arguments": {
"query": "..."
}
}
}search_disease_genesread-onlyFind genes associated with an exact MONDO identifier or disease-name search. Returns ClinGen validity …
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.
| Parameter | Type | Description | |
|---|---|---|---|
limit | integer | optional | Maximum number of source assertions per page, from 1 to 50. |
offset | integer | optional | Zero-based assertion offset; use the returned nextOffset when present. |
disease | string | required | One public disease name or exact MONDO identifier (MONDO: followed by seven digits). A name search may match multiple distinct diseases. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_disease_genes",
"arguments": {
"disease": "..."
}
}
}search_gene_literatureread-onlyRetrieve a live publication capture for a resolved gene_id and snapshot_id. Returns source links, match …
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.
| Parameter | Type | Description | |
|---|---|---|---|
gene_id | string | required | Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous. |
snapshot_id | string | required | identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable. |
limit | integer | optional | Maximum publication records in one live discovery page, from 1 to 25. |
sort | string | optional | Discovery ordering. Keep the same sort for continuation pages. One of: relevance, newest, oldest |
cursor | string | null | optional | Opaque next_cursor returned for this same gene, snapshot and sort. Omit for the first page. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_gene_literature",
"arguments": {
"gene_id": "...",
"snapshot_id": "..."
}
}
}search_literature_corpusread-onlySearch the genetics Literature Corpus by question, PMID, DOI, PMCID, gene, variant, phenotype, HPO or OMIM …
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.
| Parameter | Type | Description | |
|---|---|---|---|
query | string | required | Natural-language literature question or exact PMID, DOI, PMCID, gene, variant, phenotype, HPO, or OMIM query. Include every known publication identifier when comparing or finding related papers. |
limit | integer | optional | Maximum number of publications to return, from 1 to 25. |
sort | string | optional | Result ordering: relevance-ranked, newest publication first, or oldest publication first. One of: relevance, newest, oldest |
cursor | string | null | optional | Opaque continuation cursor from the preceding response for the same query and sort order; omit for the first page. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_literature_corpus",
"arguments": {
"query": "..."
}
}
}search_variant_literatureread-onlyResolve one GRCh38 germline variant and retrieve publications from the PubMed-derived genetics corpus. Exact …
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.
| Parameter | Type | Description | |
|---|---|---|---|
assembly | string | optional | Reference genome assembly. Folklore currently accepts GRCh38 only. |
query | string | required | One germline nuclear SNV or simple indel to resolve before retrieving its literature; this is a variant identifier, not a natural-language question. Accepts a returned Folklore canonical_key in GRCh38:chrN:position:REF:ALT form. |
question | string | null | optional | Optional natural-language focus applied after the variant is resolved, such as a condition or evidence question; do not put the variant identifier here. |
limit | integer | optional | Maximum number of publications to return, from 1 to 25. |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_variant_literature",
"arguments": {
"query": "..."
}
}
}support_helenaread-onlyRetrieve Helena Good campaign, rules, manifest and MCP connection URLs.
Retrieve Helena Good campaign, rules, manifest and MCP connection URLs.
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "support_helena",
"arguments": {}
}
}Resources 1
folklore-variant-classification-viewInteractive, read-only rendering of Folklore variant classifications.
Prompts 5
classify_germline_variantResolve one GRCh38 germline variant and report its automated ACMG/AMP classification, applied criteria, annotations and source provenance.assess_vusAssess the classification and applied criteria for a variant of uncertain significance.explain_acmg_classificationExplain the returned ACMG/AMP criteria and source annotations for one supported variant.verify_variant_identityResolve one public variant expression to its normalized identity and stop for user disambiguation rather than selecting an allele.compare_variant_literatureResolve a variant and compare its classification and annotations with associated publications.
Badge
Maintain this server? Put its live status in your README:
[](https://mcp.aianytime.net/s/folklore-clinical-variant-interpretation-mcp/)Edit this entry · Report a problem
More in Knowledge, memory & context
Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt
Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers