# Folklore Clinical Variant Interpretation MCP

> Folklore Clinical Variant Interpretation MCP is a freemium MCP server for health and science. Classify germline variants with ACMG/AMP criteria and linked literature and gene data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://folklore.helena.bio
- **Repository:** https://github.com/helena-bioinformatics/folklore-mcp
- **MCP Registry name:** io.github.helena-bioinformatics/folklore
- **Categories:** health and science
- **Listing updated:** 2026-11-14

## About

Public tools need no sign-in. classify_germline_variant takes one GRCh38 nuclear SNV or simple indel under 50 bp, in HGVS, SPDI, rsID or coordinate form, and returns an automated ACMG/AMP classification with reported criteria, annotations, source evidence and provenance. Submitted ClinVar assertions keep their own attribution beside Folklore's call, and a VUS is a legitimate outcome. Results carry typed statuses such as resolved, ambiguous and not_found so clients know what to do next.

Other public tools search variant and gene literature, fetch a PMID's abstract, retrieve ClinGen gene-disease assertions by gene or by MONDO identifier, and read HGNC gene profiles in sections. Anonymous callers get 11 tools. A Folklore API key sent as a Bearer header unlocks 18 more for case, source and result workflows on the same endpoint.

The web app's published counts range from 201,296 pathogenic records to 8,890,648 benign ones. Hosted case analysis is subscription based, from a free tier with signup credits to custom enterprise plans.

## Features

- **ACMG/AMP classification:** Automated classification with reported criteria and source evidence.
- **Flexible variant input:** Accepts HGVS, SPDI, rsID and genomic coordinates.
- **ClinGen associations:** Gene-disease and disease-gene assertions with validity and inheritance.
- **Literature search:** Finds publications for a variant, gene or scientific question.
- **Typed outcomes:** Clear statuses for resolved, ambiguous, unsupported and not found.
- **Case workflows:** An API key adds 18 case, source and result tools.

## Good for

- Classify a variant found in a patient report
- Check ClinGen evidence for a gene and disease
- Pull literature for a resolved variant
- Resolve an ambiguous variant to an explicit allele
- Run case analysis from an authenticated assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http folklore https://api.helena.bio/folklore/v1/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "folklore": {
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "folklore": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "folklore": {
      "serverUrl": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "folklore": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}
```

## Tools

- `classify_germline_variant`: Resolves, classifies and assesses one supported germline variant.
- `search_variant_literature`: Retrieves publications linked to a resolved variant.
- `get_publication_details`: Returns the bibliographic record and abstract for a PMID.
- `search_literature_corpus`: Searches publications by scientific question or identifier.
- `get_gene_disease_associations`: Retrieves ClinGen assertions for a gene symbol or HGNC ID.
- `search_disease_genes`: Retrieves ClinGen assertions by MONDO ID or disease name.
- `resolve_gene`: Resolves a human gene symbol, alias or identifier.
- `get_gene_profile`: Reads the selected HGNC gene profile.
- `get_gene_section`: Continues one profile section using a cursor.
- `search_gene_literature`: Retrieves a live publication capture for a gene.

## FAQ

### Which variants are supported?

One public GRCh38 nuclear germline SNV or simple indel smaller than 50 bp.

### Do I need an account?

Not for the 11 public tools. An API key adds 18 case-related tools.

### What does a paid plan cost?

Individual is €590 a month, Team €1,240 and Complete €1,890, excluding VAT; Free gives 3 credits once.

### What happens when no confident class applies?

A VUS is reported as a valid outcome, and ambiguous or missing results have their own statuses.

### Is Folklore Clinical Variant Interpretation MCP free?

Folklore Clinical Variant Interpretation MCP has a free plan, with paid plans for more usage or features.

### How do I add Folklore Clinical Variant Interpretation MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http folklore https://api.helena.bio/folklore/v1/mcp

### What are the best alternatives to Folklore Clinical Variant Interpretation MCP?

The closest alternatives to Folklore Clinical Variant Interpretation MCP are Tooluniverse, Oya Browser, Later Stages, MedXpert 标准检索连接器 and MedXpert 全球法规连接器 (reg-connector).

## Alternatives

- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [MedXpert 标准检索连接器](https://ai-powered.com/mcp/medxpert-2): MedXpert 标准检索连接器 is a free MCP server for legal and government.
- [MedXpert 全球法规连接器 (reg-connector)](https://ai-powered.com/mcp/medxpert-reg-connector): MedXpert 全球法规连接器 (reg-connector) is a free MCP server for legal and government.
- [Splyt](https://ai-powered.com/mcp/splyt): Splyt is a free MCP server for health and science.
- [Health Agent](https://ai-powered.com/mcp/health-agent): Health Agent is an MCP server for health and science.
- [Pausila](https://ai-powered.com/mcp/pausila): Pausila is a free MCP server for local services.

---
Source: https://ai-powered.com/mcp/folklore-clinical-variant-interpretation-mcp
