Skip to content

Disease tools

alphafold_sovereign.tools.disease

Disease ontology and clinical intelligence MCP tools.

11 tools spanning: - MONDO disease lookup and hierarchy traversal - HPO phenotype-to-disease and gene-to-phenotype - Common disease protein target profiling (all major ICD chapters) - Open Targets disease-target evidence scoring - Variant 3-D triage (HGVS → ClinVar + gnomAD constraint + disease context) - Phenotype-to-structure pipeline - Cross-disease structural comparison

All tools are read-only, idempotent, and append a provenance footer with server version, request timestamp, and data-source identifiers.

lookup_disease async

lookup_disease(params: MONDOLookupInput) -> str

Retrieve a disease record from the MONDO unified disease ontology.

Returns the canonical MONDO entry with: - Disease name, definition, synonyms - ICD-10 / ICD-11 codes (for clinical coding / EHR integration) - OMIM, Orphanet, MeSH, DOID cross-references - Immediate parent and child terms in the MONDO hierarchy

Example: lookup_disease(mondo_id='MONDO:0005010') returns the record for coronary artery disease.

search_diseases async

search_diseases(params: MONDOSearchInput) -> str

Search for diseases by name or keyword using the MONDO ontology.

Returns a ranked list of matching diseases with MONDO IDs and cross-references. Useful for resolving a clinical term to a canonical identifier before querying targets or phenotypes.

Example: search_diseases(query='breast cancer', limit=5)

lookup_phenotype async

lookup_phenotype(params: HPOTermInput) -> str

Retrieve an HPO phenotype term with associated disease annotations.

Returns: - Phenotype label, definition, synonyms - Diseases annotated with this phenotype (from HPO + OMIM + Orphanet) - Parent phenotype terms

Example: lookup_phenotype(hpo_id='HP:0001250') returns the Seizure phenotype with ~400 associated diseases.

get_gene_phenotype_profile async

get_gene_phenotype_profile(params: GenePhenotypeInput) -> str

Return all HPO phenotypes associated with a gene, plus gnomAD constraint.

Useful for understanding the clinical consequences of variants in a gene before requesting structural context.

Returns: - HPO phenotypes linked to the gene (from HPO association database) - gnomAD LOEUF / pLI constraint scores - A one-line reading of the LOEUF band (highly constrained, moderately constrained, or not constrained by this metric). It reports depletion of loss-of-function variants in gnomAD; it does not establish haploinsufficiency, and an unconstrained gene can still carry pathogenic loss-of-function variants

Example: get_gene_phenotype_profile(gene_symbol='SCN1A')

get_disease_targets async

get_disease_targets(params: DiseaseTargetsInput) -> str

Return top protein targets for a disease with Open Targets evidence scores.

Evidence score breakdown (0–1 per data type): - genetic_association: GWAS + rare-variant signals - somatic_mutation: Cancer somatic variant evidence - known_drug: Approved or clinical-stage drugs - affected_pathway: Pathway membership (Reactome, SIGNOR) - literature: Text-mining evidence (Europe PMC) - animal_model: Knockout / model organism phenotypes - rna_expression: Differential expression evidence

drug_count is the target's Open Targets drug-and-clinical-candidate record count (all stages) and tractable is true when any Open Targets tractability bucket is set; both are observed per row and are null only when the source omits them.

Example: get_disease_targets(disease_id='MONDO:0007254', limit=15) returns top 15 targets for breast carcinoma.

get_target_diseases async

get_target_diseases(params: TargetDiseaseInput) -> str

Return all diseases associated with a protein target via Open Targets.

Accepts a UniProt accession and returns the full disease landscape for that target — essential for target-validation and indication-expansion.

Example: get_target_diseases(uniprot_id='P04637') returns all diseases associated with TP53 / p53.

get_common_disease_targets async

get_common_disease_targets(params: CommonDiseaseInput) -> str

Profile the top drug targets for a curated set of common diseases in one call.

Use this for a fast landscape scan across a whole disease area: given a category (e.g. 'oncology'), it looks up the curated MONDO diseases in that category and returns each one's top Open Targets evidence-scored targets, in parallel. To profile a single disease you already have a MONDO ID for, use get_disease_targets instead — this tool is its category-level, multi-disease counterpart and does not accept a raw MONDO ID.

Queries Open Targets live. Returns a JSON string with the category and a profile object mapping each disease to its MONDO ID and top targets. A lookup that fails is reported inline as that disease's error, not raised. status summarises the lookups: success when every one answered, partial when some failed, error when all failed and no targets were retrieved. diseases_requested, diseases_profiled (lookups that succeeded) and diseases_failed give the counts. A failed lookup is not evidence that a disease has no associated targets. Returns a JSON error object listing the valid values when the category — or a disease_name filter within it — is not recognised.

Input fields

params.category: Disease area to profile. One of: cardiovascular, oncology, neurodegeneration, metabolic, autoimmune, respiratory, infectious, psychiatric, rare. params.disease_name: Restrict to one disease within the category (case- insensitive substring match, e.g. 'alzheimer'); leave blank to profile every disease in the category. params.target_limit: Maximum top targets to return per disease (1–50).

triage_variant_3d async

triage_variant_3d(params: VariantTriageInput) -> str

Retrieve source-reported variant evidence for research.

Fuses the upstream signals this tool currently wires into a single prioritised report:

  1. Pathogenicity — ClinVar interpretation + review status. The alphamissense_score / alphamissense_interpretation fields are always null / "Not available" here: AlphaMissense is not wired into this tool. For an AlphaMissense pathogenicity score use generate_variant_clinical_report.
  2. Population genetics — gnomAD LOEUF / pLI gene-constraint scores. Per-variant allele frequencies and the per-ancestry breakdown are not wired into this tool.
  3. Disease associations — a placeholder note pointing at get_target_diseases(); the Open Targets / MONDO traversal is a roadmap (Wave-3) item.
  4. Structural context — a text note pointing at analyze_structural_confidence (resolve the gene to a UniProt accession first); the AlphaFold pLDDT / PAE join into this report is a roadmap (Wave-3) item.

Returns the legacy pathogenicity_tier key as NOT_ASSESSED. Raw verified ClinVar classifications remain source-attributed in the pathogenicity section; they are not converted into a local risk tier. Gene-relative candidates remain explicitly unverified. AlphaMissense is not wired into this particular tool. The report is not a calibrated risk estimate.

status summarises the evidence lookups that were attempted: success when none failed, partial when some failed and some answered, error when all failed and no source evidence was retrieved. data_sources_status gives each source's state, and lookup_summary groups the sources into attempted, answered, failed and skipped with a reason for each failure. A lookup that finds nothing (no_data) is an answer. gnomAD is skipped, and counts neither way, when include_gnomad is false or a transcript's gene could not be verified. A failed lookup is not evidence about the variant: the fields it feeds keep their defaults (clinvar_classification "Not provided", empty population_genetics).

Example: triage_variant_3d(hgvs='BRCA1:c.181T>G')

phenotype_to_structures async

phenotype_to_structures(params: PhenotypeToStructureInput) -> str

Map a clinical phenotype to the protein structures of its disease targets.

Pipeline: 1. Resolve HPO term → associated diseases 2. For each disease → top protein targets (Open Targets) 3. For each target → UniProt ID (for AlphaFold retrieval)

Use the returned UniProt IDs with analyze_structural_confidence to retrieve AlphaFold structural confidence (pLDDT/PAE).

Example: phenotype_to_structures(hpo_id='HP:0002621') maps Atherosclerosis → disease targets → UniProt IDs.

compare_disease_target_overlap async

compare_disease_target_overlap(params: DiseaseSimilarityInput) -> str

Compare the protein target landscapes of two diseases.

Identifies shared and unique targets between two diseases — a key analysis for drug repurposing, identifying shared mechanisms, and understanding comorbidity.

Returns: - Shared targets (present in both disease target sets) - Unique to Disease A / Disease B - Jaccard similarity score of target sets

``compare_disease_target_overlap(

mondo_id_a='MONDO:0004975', # Alzheimer disease mondo_id_b='MONDO:0005180', # Parkinson disease

)``

resolve_icd10_to_mondo async

resolve_icd10_to_mondo(params: ICD10ToMONDOInput) -> str

Resolve an ICD-10 clinical code to MONDO disease ontology terms.

Enables integration between clinical / EHR data (which uses ICD-10) and the research-grade MONDO ontology used by Open Targets, HPO, and this MCP.

Example: resolve_icd10_to_mondo(icd10_code='I21.0') maps ST-elevation MI (ICD-10) to MONDO coronary disease terms.