Folklore Clinical Variant Interpretation MCP

{'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. No patient data.'}, '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}

{'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}, 'UsageBoundary': {'type': 'object', 'title': 'UsageBoundary', 'required': ['intended_use', 'patient_context_evaluated', 'review_required', 'not_for'], 'properties': {'not_for': {'type': 'array', 'items': {'enum': ['patient_diagnosis', 'treatment_decision', 'variant_pathogenicity_classification'], 'type': 'string'}, 'title': 'Not For'}, 'intended_use': {'type': 'string', 'const': 'professional_gene_disease_review', 'title': 'Intended Use'}, 'review_required': {'type': 'boolean', 'const': True, 'title': 'Review Required'}, 'patient_context_evaluated': {'type': 'boolean', 'const': False, 'title': 'Patient Context Evaluated'}}, 'additionalProperties': False}}, 'title': 'GeneDiseaseResponse', 'required': ['contractVersion', 'status', 'query', 'associations', 'pagination', 'source', 'warnings', 'usage_boundary'], '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}, 'usage_boundary': {'$ref': '#/$defs/UsageBoundary'}, 'contractVersion': {'type': 'string', 'const': '1.0', 'title': 'Contractversion'}}, 'additionalProperties': False}

{'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}

{'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': None}, 'allowed': {'type': 'boolean', 'title': 'Allowed', 'default': False}, 'license': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'License', 'default': None}, 'evidence_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Evidence Url', 'default': None}}, '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}}, 'title': 'PublicationDetailsResponse', 'required': ['contract_version', 'publication', 'usage_boundary'], 'properties': {'publication': {'$ref': '#/$defs/PublicPublicationDetails'}, 'usage_boundary': {'type': 'object', 'title': 'Usage Boundary', 'additionalProperties': True}, 'contract_version': {'type': 'string', 'const': '1.0', 'title': 'Contract Version'}}, 'additionalProperties': False}

{'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. No symptoms or patient narrative.'}}, 'additionalProperties': False}

{'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}, 'UsageBoundary': {'type': 'object', 'title': 'UsageBoundary', 'required': ['intended_use', 'patient_context_evaluated', 'review_required', 'not_for'], 'properties': {'not_for': {'type': 'array', 'items': {'enum': ['patient_diagnosis', 'treatment_decision', 'variant_pathogenicity_classification'], 'type': 'string'}, 'title': 'Not For'}, 'intended_use': {'type': 'string', 'const': 'professional_gene_disease_review', 'title': 'Intended Use'}, 'review_required': {'type': 'boolean', 'const': True, 'title': 'Review Required'}, 'patient_context_evaluated': {'type': 'boolean', 'const': False, 'title': 'Patient Context Evaluated'}}, 'additionalProperties': False}}, 'title': 'GeneDiseaseResponse', 'required': ['contractVersion', 'status', 'query', 'associations', 'pagination', 'source', 'warnings', 'usage_boundary'], '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}, 'usage_boundary': {'$ref': '#/$defs/UsageBoundary'}, 'contractVersion': {'type': 'string', 'const': '1.0', 'title': 'Contractversion'}}, 'additionalProperties': False}

{'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': None, 'description': 'Opaque continuation cursor from the preceding response for the same query and sort order; omit for the first page.'}}, 'additionalProperties': False}

{'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.0}, 'source_url': {'type': 'string', 'title': 'Source Url'}, 'graph_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Graph Score', 'default': None}, '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': None}, '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': None}}, '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}}, 'title': 'PublicCorpusSearchResponse', 'required': ['contract_version', 'query', 'returned_count', 'results', 'searchable_fields', 'usage_boundary'], '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': None}, 'graph_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Graph Version', 'default': None}, 'returned_count': {'type': 'integer', 'title': 'Returned Count'}, 'usage_boundary': {'type': 'object', 'title': 'Usage Boundary', 'additionalProperties': True}, 'contract_version': {'type': 'string', 'const': '1.0', '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': None}, 'semantic_degraded_reason': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Semantic Degraded Reason', 'default': None}}, 'additionalProperties': False}

{'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}

{'type': 'object', 'required': ['contract_version', 'record_url', 'result', 'usage_boundary', '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'}]}, 'usage_boundary': {'type': 'object', 'required': ['result_type', 'review_required', 'patient_context_evaluated', 'intended_use', 'not_for'], 'properties': {'not_for': {'type': 'array', 'items': {'enum': ['patient_diagnosis', 'treatment_decision', 'standalone_clinical_reporting'], 'type': 'string'}, 'maxItems': 3, 'minItems': 3, 'uniqueItems': True}, 'result_type': {'type': 'string', 'const': 'automated_variant_level_classification'}, 'intended_use': {'type': 'string', 'const': 'professional_variant_review'}, 'review_required': {'type': 'boolean', 'const': True}, 'patient_context_evaluated': {'type': 'boolean', 'const': False}}, 'additionalProperties': False}, 'contract_version': {'type': 'string', 'const': '1'}}, 'additionalProperties': False}

{'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': None, '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}

{'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}}, 'title': 'PublicVariantLiteratureResponse', 'required': ['status', 'variant_result', 'literature', 'usage_boundary'], 'properties': {'status': {'enum': ['resolved', 'ambiguous', 'not_found', 'invalid_request', 'unsupported', 'resolution_unavailable'], 'type': 'string', 'title': 'Status'}, 'literature': {'anyOf': [{'$ref': '#/$defs/LiteratureAuthorityResponse'}, {'type': 'null'}]}, 'usage_boundary': {'type': 'object', 'title': 'Usage Boundary', 'additionalProperties': True}, 'variant_result': {'type': 'object', 'title': 'Variant Result', 'additionalProperties': True}, 'contract_version': {'type': 'string', 'const': '1.0', 'title': 'Contract Version', 'default': '1.0'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'additionalProperties': True}