Koskamo

Folklore MCP

Folklore MCP 1.7.0 provides ACMG/AMP germline variant classification, gene profiles, disease associations and literature through 11 tools. Public GRCh38 germline nuclear SNVs and simple indels smaller than 50 bp; no patient, family or private case data. Free Streamable HTTP, no account or API key. Results require qualified professional review. Apache-2.0 applies to the public adapter only.

Visit Helena Bioinformatics

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Folklore MCP logo, by Helena BioinformaticsVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-03Operated by Helena Bioinformatics
MCP endpoint (Streamable HTTP)
https://api.helena.bio/folklore/v1/mcp
Vendor documentation

What its tools do

11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (11)

11 of 11 have a description · 11 of 11 declare behavior hints · 10 of 10 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Owner proved control of this listing's domain
  • Passed Endpoint answered the live check ·
  • Passed Endpoint and vendor documentation share a domain
  • Warning Advertises resources/templates/list but does not implement it
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • ACMG/AMP germline variant classification
  • Gene profiles and disease associations
  • Scientific literature evidence

Protocol and capabilities

Server
folklore 1.7.0
MCP protocol negotiated in check
2025-11-25
Tools
11 advertised
Resources
1 advertised
Resource templates
Not advertised
Prompts
5 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  },
  "experimental": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Resolve a gene with resolve_gene, then use its selected HGNC gene_id and identity_snapshot_id as snapshot_id for get_gene_profile. get_gene_section provides continuation pages; search_gene_literature provides a separate live capture. Keep returned source assertions, snapshot identity and coverage. Use get_gene_disease_associations with an exact gene symbol or HGNC ID, or search_disease_genes with a disease name or MONDO ID. Returns ClinGen source assertions with distinct disease identities. Use classify_germline_variant for germline variant classification, VUS assessment, ClinVar assertions, population frequencies and normalized identity. Use search_literature_corpus for scientific-literature questions, supplying known PMID, DOI or PMCID identifiers. support_helena returns information about Helena Good.

Tools

11 advertised

classify_germline_variant — Classify or interpret a germline variant under ACMG/AMP
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

classify_germline_variant input schema
{
  "type": "object",
  "title": "SearchVariantArguments",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "title": "Query",
      "maxLength": 512,
      "minLength": 1,
      "description": "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."
    },
    "assembly": {
      "type": "string",
      "const": "GRCh38",
      "title": "Assembly",
      "default": "GRCh38",
      "description": "Reference genome assembly. Folklore currently accepts GRCh38 only."
    }
  },
  "description": "The only public scientific input admitted by the MCP tool.",
  "additionalProperties": false
}
classify_germline_variant output schema
{
  "type": "object",
  "required": [
    "contract_version",
    "record_url",
    "result",
    "adapter_error"
  ],
  "properties": {
    "result": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "search_contract_version",
            "status"
          ],
          "properties": {
            "status": {
              "enum": [
                "resolved",
                "ambiguous",
                "not_found",
                "invalid_request",
                "unsupported",
                "resolution_unavailable"
              ],
              "type": "string"
            },
            "search_contract_version": {
              "type": "string",
              "const": "1.0"
            }
          },
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "record_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "adapter_error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "properties": {
            "code": {
              "type": "string",
              "minLength": 1
            },
            "message": {
              "type": "string",
              "minLength": 1
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "contract_version": {
      "type": "string",
      "const": "2"
    }
  },
  "additionalProperties": false
}
classify_germline_variant annotations
{
  "title": "Classify or interpret a germline variant under ACMG/AMP",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_variant_literature — Find literature for a germline variant
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_variant_literature input schema
{
  "type": "object",
  "title": "SearchVariantLiteratureArguments",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum number of publications to return, from 1 to 25."
    },
    "query": {
      "type": "string",
      "title": "Query",
      "maxLength": 512,
      "minLength": 1,
      "description": "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."
    },
    "assembly": {
      "type": "string",
      "const": "GRCh38",
      "title": "Assembly",
      "default": "GRCh38",
      "description": "Reference genome assembly. Folklore currently accepts GRCh38 only."
    },
    "question": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 500,
          "minLength": 3
        },
        {
          "type": "null"
        }
      ],
      "title": "Question",
      "default": null,
      "description": "Optional natural-language focus applied after the variant is resolved, such as a condition or evidence question; do not put the variant identifier here."
    }
  },
  "additionalProperties": false
}
search_variant_literature output schema
{
  "type": "object",
  "$defs": {
    "CorpusProvenance": {
      "type": "object",
      "title": "CorpusProvenance",
      "required": [
        "source",
        "publication_count",
        "latest_publication_date",
        "retrieved_at",
        "semantic_index_used"
      ],
      "properties": {
        "source": {
          "type": "string",
          "const": "Helena Literature Corpus canonical works",
          "title": "Source"
        },
        "retrieved_at": {
          "type": "string",
          "title": "Retrieved At"
        },
        "publication_count": {
          "type": "integer",
          "title": "Publication Count"
        },
        "semantic_index_used": {
          "type": "boolean",
          "title": "Semantic Index Used"
        },
        "latest_publication_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Latest Publication Date"
        }
      },
      "additionalProperties": false
    },
    "LiteraturePublication": {
      "type": "object",
      "title": "LiteraturePublication",
      "required": [
        "pmid",
        "title",
        "abstract_excerpt",
        "journal",
        "publication_date",
        "doi",
        "pmc_id",
        "pubmed_url",
        "match_type",
        "matched_variant",
        "mention_context",
        "phenotype_terms",
        "structured_score"
      ],
      "properties": {
        "doi": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Doi"
        },
        "pmid": {
          "type": "string",
          "title": "Pmid",
          "pattern": "^[0-9]{1,12}$"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "pmc_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pmc Id"
        },
        "journal": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Journal"
        },
        "match_type": {
          "enum": [
            "exact_variant",
            "variant_alias",
            "gene_association"
          ],
          "type": "string",
          "title": "Match Type"
        },
        "pubmed_url": {
          "type": "string",
          "title": "Pubmed Url"
        },
        "matched_variant": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Matched Variant"
        },
        "mention_context": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Mention Context"
        },
        "phenotype_terms": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Phenotype Terms"
        },
        "abstract_excerpt": {
          "type": "string",
          "title": "Abstract Excerpt"
        },
        "publication_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Publication Date"
        },
        "structured_score": {
          "type": "number",
          "title": "Structured Score"
        }
      },
      "additionalProperties": false
    },
    "LiteratureAuthorityResponse": {
      "type": "object",
      "title": "LiteratureAuthorityResponse",
      "required": [
        "contract_version",
        "assembly",
        "canonical_key",
        "gene_symbol",
        "aliases",
        "question",
        "candidate_count",
        "publications",
        "provenance",
        "limitations"
      ],
      "properties": {
        "aliases": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Aliases"
        },
        "assembly": {
          "type": "string",
          "const": "GRCh38",
          "title": "Assembly"
        },
        "question": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Question"
        },
        "provenance": {
          "$ref": "#/$defs/CorpusProvenance"
        },
        "gene_symbol": {
          "type": "string",
          "title": "Gene Symbol"
        },
        "limitations": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Limitations"
        },
        "publications": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/LiteraturePublication"
          },
          "title": "Publications"
        },
        "canonical_key": {
          "type": "string",
          "title": "Canonical Key"
        },
        "candidate_count": {
          "type": "integer",
          "title": "Candidate Count"
        },
        "contract_version": {
          "type": "string",
          "const": "1.0",
          "title": "Contract Version"
        }
      },
      "additionalProperties": false
    }
  },
  "anyOf": [
    {
      "type": "object",
      "title": "PublicVariantLiteratureResponse",
      "required": [
        "status",
        "variant_result",
        "literature"
      ],
      "properties": {
        "status": {
          "enum": [
            "resolved",
            "ambiguous",
            "not_found",
            "invalid_request",
            "unsupported",
            "resolution_unavailable"
          ],
          "type": "string",
          "title": "Status"
        },
        "literature": {
          "anyOf": [
            {
              "$ref": "#/$defs/LiteratureAuthorityResponse"
            },
            {
              "type": "null"
            }
          ]
        },
        "variant_result": {
          "type": "object",
          "title": "Variant Result",
          "additionalProperties": true
        },
        "contract_version": {
          "type": "string",
          "const": "2",
          "title": "Contract Version",
          "default": "2"
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "contract_version",
        "record_url",
        "result",
        "adapter_error"
      ],
      "properties": {
        "result": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "search_contract_version",
                "status"
              ],
              "properties": {
                "status": {
                  "enum": [
                    "resolved",
                    "ambiguous",
                    "not_found",
                    "invalid_request",
                    "unsupported",
                    "resolution_unavailable"
                  ],
                  "type": "string"
                },
                "search_contract_version": {
                  "type": "string",
                  "const": "1.0"
                }
              },
              "additionalProperties": true
            },
            {
              "type": "null"
            }
          ]
        },
        "record_url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        },
        "adapter_error": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "code",
                "message",
                "retryable"
              ],
              "properties": {
                "code": {
                  "type": "string",
                  "minLength": 1
                },
                "message": {
                  "type": "string",
                  "minLength": 1
                },
                "retryable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "contract_version": {
          "type": "string",
          "const": "2"
        }
      },
      "additionalProperties": false
    }
  ]
}
search_variant_literature annotations
{
  "title": "Find literature for a germline variant",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_publication_details — Get details for a PubMed publication
Advertised by the server during the last successful anonymous check.
Advertised read-only

Retrieve one PMID from the PubMed-derived genetics corpus, including title, abstract, authors, journal, publication types, MeSH terms, gene and variant mentions, retraction status and PubMed/PMC links.

get_publication_details input schema
{
  "type": "object",
  "title": "GetPublicationDetailsArguments",
  "required": [
    "pmid"
  ],
  "properties": {
    "pmid": {
      "type": "string",
      "title": "Pmid",
      "pattern": "^[0-9]{1,12}$",
      "description": "One PubMed identifier to look up in Folklore's current corpus, as 1 to 12 digits without a PMID prefix."
    }
  },
  "additionalProperties": false
}
get_publication_details output schema
{
  "type": "object",
  "$defs": {
    "PublicGeneMention": {
      "type": "object",
      "title": "PublicGeneMention",
      "required": [
        "gene_symbol",
        "association_type",
        "mention_count"
      ],
      "properties": {
        "gene_symbol": {
          "type": "string",
          "title": "Gene Symbol"
        },
        "mention_count": {
          "type": "integer",
          "title": "Mention Count"
        },
        "association_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Association Type"
        }
      },
      "additionalProperties": false
    },
    "PublicAbstractReuse": {
      "type": "object",
      "title": "PublicAbstractReuse",
      "properties": {
        "source": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Source",
          "default": null
        },
        "allowed": {
          "type": "boolean",
          "title": "Allowed",
          "default": false
        },
        "license": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "License",
          "default": null
        },
        "evidence_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Evidence Url",
          "default": null
        }
      },
      "additionalProperties": false
    },
    "PublicVariantMention": {
      "type": "object",
      "title": "PublicVariantMention",
      "required": [
        "gene_symbol",
        "hgvs_cdna",
        "hgvs_protein",
        "normalized_variant",
        "clinical_significance",
        "evidence_type",
        "sentence_text",
        "confidence_score"
      ],
      "properties": {
        "hgvs_cdna": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgvs Cdna"
        },
        "gene_symbol": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Gene Symbol"
        },
        "hgvs_protein": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgvs Protein"
        },
        "evidence_type": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Evidence Type"
        },
        "sentence_text": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sentence Text"
        },
        "confidence_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Confidence Score"
        },
        "normalized_variant": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Normalized Variant"
        },
        "clinical_significance": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Clinical Significance"
        }
      },
      "additionalProperties": false
    },
    "PublicPublicationDetails": {
      "type": "object",
      "title": "PublicPublicationDetails",
      "required": [
        "pmid",
        "title",
        "abstract",
        "authors",
        "journal",
        "publication_date",
        "publication_types",
        "mesh_terms",
        "doi",
        "pmc_id",
        "is_retracted",
        "pubmed_url",
        "full_text_url",
        "gene_mentions",
        "variant_mentions"
      ],
      "properties": {
        "doi": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Doi"
        },
        "pmid": {
          "type": "string",
          "title": "Pmid",
          "pattern": "^[0-9]{1,12}$"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "pmc_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pmc Id"
        },
        "authors": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Authors"
        },
        "journal": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Journal"
        },
        "abstract": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Abstract"
        },
        "mesh_terms": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Mesh Terms"
        },
        "pubmed_url": {
          "type": "string",
          "title": "Pubmed Url"
        },
        "is_retracted": {
          "type": "boolean",
          "title": "Is Retracted"
        },
        "full_text_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Full Text Url"
        },
        "gene_mentions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PublicGeneMention"
          },
          "title": "Gene Mentions"
        },
        "abstract_reuse": {
          "$ref": "#/$defs/PublicAbstractReuse"
        },
        "publication_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Publication Date"
        },
        "variant_mentions": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PublicVariantMention"
          },
          "title": "Variant Mentions"
        },
        "publication_types": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Publication Types"
        }
      },
      "additionalProperties": false
    }
  },
  "anyOf": [
    {
      "type": "object",
      "title": "PublicationDetailsResponse",
      "required": [
        "contract_version",
        "publication"
      ],
      "properties": {
        "publication": {
          "$ref": "#/$defs/PublicPublicationDetails"
        },
        "contract_version": {
          "type": "string",
          "const": "2",
          "title": "Contract Version"
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "contract_version",
        "record_url",
        "result",
        "adapter_error"
      ],
      "properties": {
        "result": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "search_contract_version",
                "status"
              ],
              "properties": {
                "status": {
                  "enum": [
                    "resolved",
                    "ambiguous",
                    "not_found",
                    "invalid_request",
                    "unsupported",
                    "resolution_unavailable"
                  ],
                  "type": "string"
                },
                "search_contract_version": {
                  "type": "string",
                  "const": "1.0"
                }
              },
              "additionalProperties": true
            },
            {
              "type": "null"
            }
          ]
        },
        "record_url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        },
        "adapter_error": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "code",
                "message",
                "retryable"
              ],
              "properties": {
                "code": {
                  "type": "string",
                  "minLength": 1
                },
                "message": {
                  "type": "string",
                  "minLength": 1
                },
                "retryable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "contract_version": {
          "type": "string",
          "const": "2"
        }
      },
      "additionalProperties": false
    }
  ]
}
get_publication_details annotations
{
  "title": "Get details for a PubMed publication",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_literature_corpus — Search the Folklore Literature Corpus
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_literature_corpus input schema
{
  "type": "object",
  "title": "SearchCorpusArguments",
  "required": [
    "query"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "newest",
        "oldest"
      ],
      "type": "string",
      "title": "Sort",
      "default": "relevance",
      "description": "Result ordering: relevance-ranked, newest publication first, or oldest publication first."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum number of publications to return, from 1 to 25."
    },
    "query": {
      "type": "string",
      "title": "Query",
      "maxLength": 200,
      "minLength": 3,
      "description": "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."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[A-Za-z0-9_-]+$",
          "maxLength": 128,
          "minLength": 8
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "default": null,
      "description": "Opaque continuation cursor from the preceding response for the same query and sort order; omit for the first page."
    }
  },
  "additionalProperties": false
}
search_literature_corpus output schema
{
  "type": "object",
  "$defs": {
    "PublicCorpusSearchResult": {
      "type": "object",
      "title": "PublicCorpusSearchResult",
      "required": [
        "work_id",
        "pmid",
        "title",
        "abstract_excerpt",
        "journal",
        "publication_date",
        "doi",
        "pmc_id",
        "source_url",
        "pubmed_url",
        "match_types",
        "structured_score"
      ],
      "properties": {
        "doi": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Doi"
        },
        "pmid": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[0-9]{1,12}$"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pmid"
        },
        "title": {
          "type": "string",
          "title": "Title"
        },
        "pmc_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pmc Id"
        },
        "authors": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Authors"
        },
        "journal": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Journal"
        },
        "work_id": {
          "type": "string",
          "title": "Work Id"
        },
        "pubmed_url": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Pubmed Url"
        },
        "rank_score": {
          "type": "number",
          "title": "Rank Score",
          "default": 0
        },
        "source_url": {
          "type": "string",
          "title": "Source Url"
        },
        "graph_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graph Score",
          "default": null
        },
        "match_types": {
          "type": "array",
          "items": {
            "enum": [
              "pmid",
              "doi",
              "pmcid",
              "title",
              "abstract",
              "gene",
              "variant",
              "phenotype",
              "hpo",
              "omim",
              "semantic",
              "graph"
            ],
            "type": "string"
          },
          "title": "Match Types"
        },
        "semantic_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "title": "Semantic Score",
          "default": null
        },
        "abstract_excerpt": {
          "type": "string",
          "title": "Abstract Excerpt"
        },
        "article_entities": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PublicCorpusArticleEntity"
          },
          "title": "Article Entities"
        },
        "publication_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Publication Date"
        },
        "structured_score": {
          "type": "number",
          "title": "Structured Score"
        },
        "graph_anchor_pmid": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graph Anchor Pmid",
          "default": null
        }
      },
      "additionalProperties": false
    },
    "PublicCorpusArticleEntity": {
      "type": "object",
      "title": "PublicCorpusArticleEntity",
      "required": [
        "entity_type",
        "identifier",
        "label",
        "source_field",
        "normalization_state"
      ],
      "properties": {
        "label": {
          "type": "string",
          "title": "Label"
        },
        "identifier": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Identifier"
        },
        "entity_type": {
          "enum": [
            "gene",
            "variant",
            "phenotype",
            "pmid",
            "doi",
            "pmcid",
            "omim"
          ],
          "type": "string",
          "title": "Entity Type"
        },
        "source_field": {
          "enum": [
            "work_identifiers.normalized_value",
            "gene_mentions.gene_symbol",
            "variant_mentions.normalized_variant",
            "phenotype_mentions.hpo_id",
            "phenotype_mentions.omim_id",
            "phenotype_mentions.mesh_term",
            "phenotype_mentions.phenotype_name"
          ],
          "type": "string",
          "title": "Source Field"
        },
        "normalization_state": {
          "enum": [
            "normalized",
            "source_indexed"
          ],
          "type": "string",
          "title": "Normalization State"
        }
      },
      "additionalProperties": false
    }
  },
  "anyOf": [
    {
      "type": "object",
      "title": "PublicCorpusSearchResponse",
      "required": [
        "contract_version",
        "query",
        "returned_count",
        "results",
        "searchable_fields"
      ],
      "properties": {
        "query": {
          "type": "string",
          "title": "Query"
        },
        "results": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/PublicCorpusSearchResult"
          },
          "title": "Results"
        },
        "has_more": {
          "type": "boolean",
          "title": "Has More",
          "default": false
        },
        "graph_used": {
          "type": "boolean",
          "title": "Graph Used",
          "default": false
        },
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Next Cursor",
          "default": null
        },
        "graph_version": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graph Version",
          "default": null
        },
        "returned_count": {
          "type": "integer",
          "title": "Returned Count"
        },
        "contract_version": {
          "type": "string",
          "const": "2",
          "title": "Contract Version"
        },
        "searchable_fields": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Searchable Fields"
        },
        "semantic_index_used": {
          "type": "boolean",
          "title": "Semantic Index Used",
          "default": false
        },
        "graph_degraded_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Graph Degraded Reason",
          "default": null
        },
        "semantic_degraded_reason": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Semantic Degraded Reason",
          "default": null
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "contract_version",
        "record_url",
        "result",
        "adapter_error"
      ],
      "properties": {
        "result": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "search_contract_version",
                "status"
              ],
              "properties": {
                "status": {
                  "enum": [
                    "resolved",
                    "ambiguous",
                    "not_found",
                    "invalid_request",
                    "unsupported",
                    "resolution_unavailable"
                  ],
                  "type": "string"
                },
                "search_contract_version": {
                  "type": "string",
                  "const": "1.0"
                }
              },
              "additionalProperties": true
            },
            {
              "type": "null"
            }
          ]
        },
        "record_url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        },
        "adapter_error": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "code",
                "message",
                "retryable"
              ],
              "properties": {
                "code": {
                  "type": "string",
                  "minLength": 1
                },
                "message": {
                  "type": "string",
                  "minLength": 1
                },
                "retryable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "contract_version": {
          "type": "string",
          "const": "2"
        }
      },
      "additionalProperties": false
    }
  ]
}
search_literature_corpus annotations
{
  "title": "Search the Folklore Literature Corpus",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
support_helena — Support Helena's free scientific infrastructure
Advertised by the server during the last successful anonymous check.
Advertised read-only

Retrieve Helena Good campaign, rules, manifest and MCP connection URLs.

support_helena input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
support_helena output schema
{
  "type": "object",
  "additionalProperties": true
}
support_helena annotations
{
  "title": "Support Helena's free scientific infrastructure",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_gene_disease_associations — Find diseases associated with a gene
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_gene_disease_associations input schema
{
  "type": "object",
  "title": "GetGeneDiseaseArguments",
  "required": [
    "gene"
  ],
  "properties": {
    "gene": {
      "type": "string",
      "title": "Gene",
      "maxLength": 64,
      "minLength": 1,
      "description": "One public human gene symbol or HGNC identifier, for example BRCA1 or HGNC:1100."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of source assertions per page, from 1 to 50."
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "description": "Zero-based assertion offset; use the returned nextOffset when present."
    }
  },
  "additionalProperties": false
}
get_gene_disease_associations output schema
{
  "type": "object",
  "$defs": {
    "Query": {
      "type": "object",
      "title": "Query",
      "required": [
        "kind",
        "value",
        "match"
      ],
      "properties": {
        "kind": {
          "enum": [
            "gene",
            "disease"
          ],
          "type": "string",
          "title": "Kind"
        },
        "match": {
          "enum": [
            "exact",
            "name_contains"
          ],
          "type": "string",
          "title": "Match"
        },
        "value": {
          "type": "string",
          "title": "Value"
        }
      },
      "additionalProperties": false
    },
    "Source": {
      "type": "object",
      "title": "Source",
      "required": [
        "name",
        "version",
        "snapshotSha256",
        "downloadUrl",
        "license",
        "attribution"
      ],
      "properties": {
        "name": {
          "type": "string",
          "const": "ClinGen Gene-Disease Validity",
          "title": "Name"
        },
        "license": {
          "type": "string",
          "const": "CC0-1.0",
          "title": "License"
        },
        "version": {
          "type": "string",
          "title": "Version"
        },
        "attribution": {
          "type": "string",
          "title": "Attribution"
        },
        "downloadUrl": {
          "type": "string",
          "title": "Downloadurl"
        },
        "snapshotSha256": {
          "type": "string",
          "title": "Snapshotsha256",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "additionalProperties": false
    },
    "Pagination": {
      "type": "object",
      "title": "Pagination",
      "required": [
        "limit",
        "offset",
        "total",
        "nextOffset"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "title": "Limit",
          "maximum": 50,
          "minimum": 1
        },
        "total": {
          "type": "integer",
          "title": "Total",
          "minimum": 0
        },
        "offset": {
          "type": "integer",
          "title": "Offset",
          "maximum": 1000,
          "minimum": 0
        },
        "nextOffset": {
          "anyOf": [
            {
              "type": "integer",
              "maximum": 1000,
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "title": "Nextoffset"
        }
      },
      "additionalProperties": false
    },
    "Association": {
      "type": "object",
      "title": "Association",
      "required": [
        "geneSymbol",
        "hgncId",
        "diseaseName",
        "diseaseId",
        "modeOfInheritance",
        "modeOfInheritanceId",
        "classification",
        "expertPanel",
        "reportUrl",
        "classificationDate",
        "sopVersion"
      ],
      "properties": {
        "hgncId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgncid"
        },
        "diseaseId": {
          "type": "string",
          "title": "Diseaseid"
        },
        "reportUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reporturl"
        },
        "geneSymbol": {
          "type": "string",
          "title": "Genesymbol"
        },
        "sopVersion": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sopversion"
        },
        "diseaseName": {
          "type": "string",
          "title": "Diseasename"
        },
        "expertPanel": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expertpanel"
        },
        "classification": {
          "type": "string",
          "title": "Classification"
        },
        "modeOfInheritance": {
          "type": "string",
          "title": "Modeofinheritance"
        },
        "classificationDate": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Classificationdate"
        },
        "modeOfInheritanceId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Modeofinheritanceid"
        }
      },
      "additionalProperties": false
    }
  },
  "anyOf": [
    {
      "type": "object",
      "title": "GeneDiseaseResponse",
      "required": [
        "contractVersion",
        "status",
        "query",
        "associations",
        "pagination",
        "source",
        "warnings"
      ],
      "properties": {
        "query": {
          "$ref": "#/$defs/Query"
        },
        "source": {
          "$ref": "#/$defs/Source"
        },
        "status": {
          "enum": [
            "ok",
            "not_found"
          ],
          "type": "string",
          "title": "Status"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Warnings"
        },
        "pagination": {
          "$ref": "#/$defs/Pagination"
        },
        "associations": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Association"
          },
          "title": "Associations",
          "maxItems": 50
        },
        "contractVersion": {
          "type": "string",
          "const": "2",
          "title": "Contractversion"
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "contractVersion",
        "adapter_error"
      ],
      "properties": {
        "adapter_error": {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "contractVersion": {
          "const": "2"
        }
      },
      "additionalProperties": false
    }
  ]
}
get_gene_disease_associations annotations
{
  "title": "Find diseases associated with a gene",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_disease_genes — Find genes associated with a disease
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_disease_genes input schema
{
  "type": "object",
  "title": "SearchDiseaseGenesArguments",
  "required": [
    "disease"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of source assertions per page, from 1 to 50."
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0,
      "maximum": 1000,
      "minimum": 0,
      "description": "Zero-based assertion offset; use the returned nextOffset when present."
    },
    "disease": {
      "type": "string",
      "title": "Disease",
      "maxLength": 160,
      "minLength": 3,
      "description": "One public disease name or exact MONDO identifier (MONDO: followed by seven digits). A name search may match multiple distinct diseases."
    }
  },
  "additionalProperties": false
}
search_disease_genes output schema
{
  "type": "object",
  "$defs": {
    "Query": {
      "type": "object",
      "title": "Query",
      "required": [
        "kind",
        "value",
        "match"
      ],
      "properties": {
        "kind": {
          "enum": [
            "gene",
            "disease"
          ],
          "type": "string",
          "title": "Kind"
        },
        "match": {
          "enum": [
            "exact",
            "name_contains"
          ],
          "type": "string",
          "title": "Match"
        },
        "value": {
          "type": "string",
          "title": "Value"
        }
      },
      "additionalProperties": false
    },
    "Source": {
      "type": "object",
      "title": "Source",
      "required": [
        "name",
        "version",
        "snapshotSha256",
        "downloadUrl",
        "license",
        "attribution"
      ],
      "properties": {
        "name": {
          "type": "string",
          "const": "ClinGen Gene-Disease Validity",
          "title": "Name"
        },
        "license": {
          "type": "string",
          "const": "CC0-1.0",
          "title": "License"
        },
        "version": {
          "type": "string",
          "title": "Version"
        },
        "attribution": {
          "type": "string",
          "title": "Attribution"
        },
        "downloadUrl": {
          "type": "string",
          "title": "Downloadurl"
        },
        "snapshotSha256": {
          "type": "string",
          "title": "Snapshotsha256",
          "pattern": "^[a-f0-9]{64}$"
        }
      },
      "additionalProperties": false
    },
    "Pagination": {
      "type": "object",
      "title": "Pagination",
      "required": [
        "limit",
        "offset",
        "total",
        "nextOffset"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "title": "Limit",
          "maximum": 50,
          "minimum": 1
        },
        "total": {
          "type": "integer",
          "title": "Total",
          "minimum": 0
        },
        "offset": {
          "type": "integer",
          "title": "Offset",
          "maximum": 1000,
          "minimum": 0
        },
        "nextOffset": {
          "anyOf": [
            {
              "type": "integer",
              "maximum": 1000,
              "minimum": 0
            },
            {
              "type": "null"
            }
          ],
          "title": "Nextoffset"
        }
      },
      "additionalProperties": false
    },
    "Association": {
      "type": "object",
      "title": "Association",
      "required": [
        "geneSymbol",
        "hgncId",
        "diseaseName",
        "diseaseId",
        "modeOfInheritance",
        "modeOfInheritanceId",
        "classification",
        "expertPanel",
        "reportUrl",
        "classificationDate",
        "sopVersion"
      ],
      "properties": {
        "hgncId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Hgncid"
        },
        "diseaseId": {
          "type": "string",
          "title": "Diseaseid"
        },
        "reportUrl": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Reporturl"
        },
        "geneSymbol": {
          "type": "string",
          "title": "Genesymbol"
        },
        "sopVersion": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Sopversion"
        },
        "diseaseName": {
          "type": "string",
          "title": "Diseasename"
        },
        "expertPanel": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Expertpanel"
        },
        "classification": {
          "type": "string",
          "title": "Classification"
        },
        "modeOfInheritance": {
          "type": "string",
          "title": "Modeofinheritance"
        },
        "classificationDate": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Classificationdate"
        },
        "modeOfInheritanceId": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "title": "Modeofinheritanceid"
        }
      },
      "additionalProperties": false
    }
  },
  "anyOf": [
    {
      "type": "object",
      "title": "GeneDiseaseResponse",
      "required": [
        "contractVersion",
        "status",
        "query",
        "associations",
        "pagination",
        "source",
        "warnings"
      ],
      "properties": {
        "query": {
          "$ref": "#/$defs/Query"
        },
        "source": {
          "$ref": "#/$defs/Source"
        },
        "status": {
          "enum": [
            "ok",
            "not_found"
          ],
          "type": "string",
          "title": "Status"
        },
        "warnings": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "title": "Warnings"
        },
        "pagination": {
          "$ref": "#/$defs/Pagination"
        },
        "associations": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/Association"
          },
          "title": "Associations",
          "maxItems": 50
        },
        "contractVersion": {
          "type": "string",
          "const": "2",
          "title": "Contractversion"
        }
      },
      "additionalProperties": false
    },
    {
      "type": "object",
      "required": [
        "contractVersion",
        "adapter_error"
      ],
      "properties": {
        "adapter_error": {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        },
        "contractVersion": {
          "const": "2"
        }
      },
      "additionalProperties": false
    }
  ]
}
search_disease_genes annotations
{
  "title": "Find genes associated with a disease",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
resolve_gene — Resolve a gene symbol, alias or stable identifier
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

resolve_gene input schema
{
  "type": "object",
  "title": "ResolveGeneArguments",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "title": "Query",
      "maxLength": 128,
      "minLength": 1,
      "description": "One public gene symbol, previous symbol, alias, HGNC ID, Ensembl gene ID or NCBI Gene ID."
    }
  },
  "additionalProperties": false
}
resolve_gene output schema
{
  "type": "object",
  "required": [
    "contract_version",
    "result",
    "record_url",
    "adapter_error"
  ],
  "properties": {
    "result": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "schema_version",
            "request_id",
            "identity_snapshot_id",
            "status",
            "candidates",
            "candidate_total",
            "complete"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "record_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "adapter_error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "available_snapshot_id"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "available_snapshot_id": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "contract_version": {
      "type": "string",
      "const": "2"
    }
  },
  "additionalProperties": false
}
resolve_gene annotations
{
  "title": "Resolve a gene symbol, alias or stable identifier",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_gene_profile — Read the complete gene profile
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_gene_profile input schema
{
  "type": "object",
  "title": "GetGeneProfileArguments",
  "required": [
    "gene_id",
    "snapshot_id"
  ],
  "properties": {
    "gene_id": {
      "type": "string",
      "title": "Gene Id",
      "pattern": "^HGNC:[1-9][0-9]*$",
      "description": "Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous."
    },
    "snapshot_id": {
      "type": "string",
      "title": "Snapshot Id",
      "pattern": "^[a-f0-9]{64}$",
      "description": "identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable."
    }
  },
  "additionalProperties": false
}
get_gene_profile output schema
{
  "type": "object",
  "required": [
    "contract_version",
    "result",
    "record_url",
    "adapter_error"
  ],
  "properties": {
    "result": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "schema_version",
            "gene_id",
            "request_id",
            "snapshot_id",
            "identity",
            "sources",
            "sections"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "record_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "adapter_error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "available_snapshot_id"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "available_snapshot_id": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "contract_version": {
      "type": "string",
      "const": "2"
    }
  },
  "additionalProperties": false
}
get_gene_profile annotations
{
  "title": "Read the complete gene profile",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_gene_section — Read a page of gene records
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_gene_section input schema
{
  "type": "object",
  "title": "GetGeneSectionArguments",
  "required": [
    "gene_id",
    "snapshot_id",
    "section"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum source records per page, from 1 to 50. Counts retain their original source unit."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 512
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "default": null,
      "description": "Opaque next_cursor returned for this same gene, snapshot and section. Omit for its first page."
    },
    "gene_id": {
      "type": "string",
      "title": "Gene Id",
      "pattern": "^HGNC:[1-9][0-9]*$",
      "description": "Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous."
    },
    "section": {
      "enum": [
        "overview",
        "disease_validity",
        "structure",
        "constraint",
        "dosage",
        "mechanisms",
        "clinical_variants",
        "clinical_variant_consequences",
        "expression",
        "gwas",
        "phenotypes",
        "protein_pathways",
        "literature"
      ],
      "type": "string",
      "title": "Section",
      "description": "Source-qualified section from the current profile. Literature is a separate live capture; use search_gene_literature for it."
    },
    "snapshot_id": {
      "type": "string",
      "title": "Snapshot Id",
      "pattern": "^[a-f0-9]{64}$",
      "description": "identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable."
    }
  },
  "additionalProperties": false
}
get_gene_section output schema
{
  "type": "object",
  "required": [
    "contract_version",
    "result",
    "record_url",
    "adapter_error"
  ],
  "properties": {
    "result": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "gene_id",
            "request_id",
            "snapshot_id",
            "section",
            "status",
            "coverage",
            "data",
            "pagination"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "record_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "adapter_error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "available_snapshot_id"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "available_snapshot_id": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "contract_version": {
      "type": "string",
      "const": "2"
    }
  },
  "additionalProperties": false
}
get_gene_section annotations
{
  "title": "Read a page of gene records",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_gene_literature — Find live literature for a resolved public gene
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_gene_literature input schema
{
  "type": "object",
  "title": "SearchGeneLiteratureArguments",
  "required": [
    "gene_id",
    "snapshot_id"
  ],
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "newest",
        "oldest"
      ],
      "type": "string",
      "title": "Sort",
      "default": "relevance",
      "description": "Discovery ordering. Keep the same sort for continuation pages."
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 20,
      "maximum": 25,
      "minimum": 1,
      "description": "Maximum publication records in one live discovery page, from 1 to 25."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 4096
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "default": null,
      "description": "Opaque next_cursor returned for this same gene, snapshot and sort. Omit for the first page."
    },
    "gene_id": {
      "type": "string",
      "title": "Gene Id",
      "pattern": "^HGNC:[1-9][0-9]*$",
      "description": "Canonical HGNC gene_id returned by resolve_gene. Select an explicit candidate when resolution is ambiguous."
    },
    "snapshot_id": {
      "type": "string",
      "title": "Snapshot Id",
      "pattern": "^[a-f0-9]{64}$",
      "description": "identity_snapshot_id returned by resolve_gene, or snapshot_id from the current gene profile. Restart resolution after snapshot_unavailable."
    }
  },
  "additionalProperties": false
}
search_gene_literature output schema
{
  "type": "object",
  "required": [
    "contract_version",
    "result",
    "record_url",
    "adapter_error"
  ],
  "properties": {
    "result": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "schema_version",
            "gene_id",
            "request_id",
            "snapshot_id",
            "captured_at",
            "capture_sha256",
            "records",
            "returned",
            "has_more",
            "next_cursor"
          ],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "record_url": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "adapter_error": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "code",
            "message",
            "retryable",
            "available_snapshot_id"
          ],
          "properties": {
            "code": {
              "type": "string"
            },
            "message": {
              "type": "string"
            },
            "retryable": {
              "type": "boolean"
            },
            "available_snapshot_id": {
              "type": [
                "string",
                "null"
              ],
              "pattern": "^[a-f0-9]{64}$"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    },
    "contract_version": {
      "type": "string",
      "const": "2"
    }
  },
  "additionalProperties": false
}
search_gene_literature annotations
{
  "title": "Find live literature for a resolved public gene",
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

5 advertised

classify_germline_variant — Classify a germline variant under ACMG/AMP

Advertised by the server during the last successful anonymous check.

Resolve one GRCh38 germline variant and report its automated ACMG/AMP classification, applied criteria, annotations and source provenance.

variant
One HGVS, SPDI, rsID or genomic coordinate expression. (required)
assess_vus — Assess a VUS

Advertised by the server during the last successful anonymous check.

Assess the classification and applied criteria for a variant of uncertain significance.

variant
One HGVS, SPDI, rsID or genomic coordinate expression. (required)
explain_acmg_classification — Explain an automated ACMG/AMP classification

Advertised by the server during the last successful anonymous check.

Explain the returned ACMG/AMP criteria and source annotations for one supported variant.

variant
One HGVS, SPDI, rsID or genomic coordinate expression. (required)
verify_variant_identity — Verify a public variant identity

Advertised by the server during the last successful anonymous check.

Resolve one public variant expression to its normalized identity and stop for user disambiguation rather than selecting an allele.

variant
One HGVS, SPDI, rsID or genomic coordinate expression. (required)
compare_variant_literature — Compare variant classification with literature

Advertised by the server during the last successful anonymous check.

Resolve a variant and compare its classification and annotations with associated publications.

variant
One HGVS, SPDI, rsID or genomic coordinate expression. (required)

Resources

1 advertised

folklore-variant-classification-view — Variant Classification

Advertised by the server during the last successful anonymous check.

Interactive, read-only rendering of Folklore variant classifications.

folklore-variant-classification-view URI
ui://folklore/variant-classification/v1.html

MIME type: text/html;profile=mcp-app

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-04: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1687 ms
95th percentile latency
1687 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1687 ms · metadata changed · 11 tool(s), 1 resource(s), 5 prompt(s); warnings: Advertises resources/templates/list but does not implement it

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http folklore-mcp https://api.helena.bio/folklore/v1/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add folklore-mcp --url https://api.helena.bio/folklore/v1/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable folklore-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "folklore-mcp": {
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "folklore-mcp": {
      "type": "streamableHttp",
      "url": "https://api.helena.bio/folklore/v1/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start folklore-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "folklore-mcp": {
      "type": "http",
      "url": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http folklore-mcp https://api.helena.bio/folklore/v1/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.helena.bio/folklore/v1/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "folklore-mcp": {
      "serverUrl": "https://api.helena.bio/folklore/v1/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Folklore MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 4,834

Do you run Folklore MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing