Awesome MCP Servers by AI Anytime

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 reachableVerifiedResponded in 488 ms
MCP handshake (initialize)VerifiedCompleted without credentials
Tool discovery (tools/list)Verified11 tools listed
AuthenticationVerifiedNone needed to connect
Protocol versionVerified2025-06-18
TransportVerifiedStreamable HTTP
Capabilities declaredVerifiedexperimental, 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/mcp

Claude Desktop

Open Settings → Connectors → Add custom connector and paste this URL:

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

Or 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

Add to 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

Add to 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

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.

ParameterTypeDescription
assemblystringoptionalReference genome assembly. Folklore currently accepts GRCh38 only.
querystringrequiredOne 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.

ParameterTypeDescription
limitintegeroptionalMaximum number of source assertions per page, from 1 to 50.
offsetintegeroptionalZero-based assertion offset; use the returned nextOffset when present.
genestringrequiredOne 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.

ParameterTypeDescription
gene_idstringrequiredCanonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous.
snapshot_idstringrequiredidentity_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.

ParameterTypeDescription
gene_idstringrequiredCanonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous.
snapshot_idstringrequiredidentity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable.
sectionstringrequiredSource-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 …
limitintegeroptionalMaximum source records per page, from 1 to 50. Counts retain their original source unit.
cursorstring | nulloptionalOpaque 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.

ParameterTypeDescription
pmidstringrequiredOne 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.

ParameterTypeDescription
querystringrequiredOne 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.

ParameterTypeDescription
limitintegeroptionalMaximum number of source assertions per page, from 1 to 50.
offsetintegeroptionalZero-based assertion offset; use the returned nextOffset when present.
diseasestringrequiredOne 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.

ParameterTypeDescription
gene_idstringrequiredCanonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous.
snapshot_idstringrequiredidentity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable.
limitintegeroptionalMaximum publication records in one live discovery page, from 1 to 25.
sortstringoptionalDiscovery ordering. Keep the same sort for continuation pages. One of: relevance, newest, oldest
cursorstring | nulloptionalOpaque 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.

ParameterTypeDescription
querystringrequiredNatural-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.
limitintegeroptionalMaximum number of publications to return, from 1 to 25.
sortstringoptionalResult ordering: relevance-ranked, newest publication first, or oldest publication first. One of: relevance, newest, oldest
cursorstring | nulloptionalOpaque 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.

ParameterTypeDescription
assemblystringoptionalReference genome assembly. Folklore currently accepts GRCh38 only.
querystringrequiredOne 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.
questionstring | nulloptionalOptional natural-language focus applied after the variant is resolved, such as a condition or evidence question; do not put the variant identifier here.
limitintegeroptionalMaximum 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

Prompts 5

Badge

Maintain this server? Put its live status in your README:

MCP status badge

[![MCP status](https://mcp.aianytime.net/badge/folklore-clinical-variant-interpretation-mcp.svg)](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