Integrations / MCP

Folklore MCP

Query public gene-disease evidence, interpret supported germline variants and search scientific literature from your AI client. No account or API key is required.

Connect your client

Add the endpoint to your AI client as a remote MCP server using Streamable HTTP.

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

Codex configuration:

[mcp_servers.folklore]
url = "https://api.helena.bio/folklore/v1/mcp"

Cursor configuration:

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

Tools

Tool	Purpose
search_variant_evidence	Resolve and interpret one supported germline variant
search_variant_literature	Find variant-related scientific literature
get_publication_details	Read publication details
search_literature_corpus	Search articles using text and known identifiers
get_gene_disease_associations	Find disease associations for a gene
search_disease_genes	Find genes associated with a disease

Supported variant queries include GRCh38 coordinates, selected HGVS forms, SPDI and rsID for nuclear germline SNVs and simple indels smaller than 50 base pairs. For ambiguous expressions, review the returned candidates and verify the intended allele.

Example questions

Which genes have curated evidence for Marfan syndrome?

Which diseases are associated with FBN1?

Classify ENST00000226413.5:c.317A>G under ACMG/AMP
and summarize its supporting evidence.

Read the evidence

Keep the resolved allele, classification, criterion evidence, source citations and limitations together. Gene-disease validity and variant classification are separate assessments.

Use public gene, disease and single-variant queries. Do not submit patient records or private case details.

Client setup and resources

Client	Configuration
ChatGPT	Custom MCP app with the endpoint above
Claude	Custom connector with the endpoint above
Codex	TOML mcp_servers entry
Cursor	JSON mcpServers entry
VS Code	Server type http with the endpoint as url

Public integration repository · MCP server card · Directory listings