Use this reference when constructing calls or interpreting public results. The public adapter repository is the source for the exact live schemas: https://github.com/helena-bioinformatics/folklore-mcp.
https://api.helena.bio/folklore/v1/mcpio.github.helena-bioinformatics/folkloreVerify tools with tools/list at call time. Do not infer tool availability from
this skill alone.
search_variant_evidenceRequired input:
assembly: GRCh38
query: <one public germline nuclear SNV or simple indel>
The query may be a coordinate, genomic/coding/protein HGVS, SPDI, rsID, or a
returned canonical_key in this form:
GRCh38:chrN:position:REF:ALT
The six public outcome states are:
resolvedambiguousnot_foundinvalid_requestunsupportedresolution_unavailableDo not collapse these states. In particular, never convert ambiguous into
resolved, and never convert resolution_unavailable into not_found.
search_variant_literatureUse only after resolution when composing an automatic workflow:
assembly: GRCh38
query: <returned canonical_key>
question: <optional public scientific focus>
limit: <1 to 25>
The response preserves the variant result and returns literature only when the
variant resolution permits it. Publication match types are exact_variant,
variant_alias, and gene_association.
get_publication_detailsInput one PMID returned by a literature tool, as digits without a PMID:
prefix. Preserve the returned bibliographic metadata, source URLs, retraction
status, gene mentions, and variant mentions.
search_literature_corpusUse for source-linked scientific-literature discovery with a natural-language question, publication identifier, gene, variant, phenotype, HPO, or OMIM concept. Inspect the live input schema for current bounds and optional controls. Keep all queries public and nonsensitive.
Request examples (not captured scientific results):
{"name":"get_gene_disease_associations","arguments":{"gene":"BRCA1","limit":20,"offset":0}}
{"name":"search_disease_genes","arguments":{"disease":"Marfan","limit":20,"offset":0}}
The gene lookup accepts an exact gene symbol or HGNC identifier. Disease lookup accepts an exact MONDO identifier or a disease-name substring. Both have limit 1–50 and offset 0–1000. Preserve distinct disease matches and returned pagination; one page is not an exhaustive catalogue.
Successful structured output directly carries query, associations, pagination, source, warnings and usage_boundary. Read JSON-RPC and adapter errors before interpreting output. The source is ClinGen Gene-Disease Validity; preserve assertion-specific inheritance, assessment, source links and dates. Missing source values stay unavailable. No result does not establish no association, and association validity is not variant pathogenicity.