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
¶
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 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
¶
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
¶
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
¶
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
¶
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
¶
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
¶
Retrieve source-reported variant evidence for research.
Fuses the upstream signals this tool currently wires into a single prioritised report:
- Pathogenicity — ClinVar interpretation + review status. The
alphamissense_score/alphamissense_interpretationfields are alwaysnull/ "Not available" here: AlphaMissense is not wired into this tool. For an AlphaMissense pathogenicity score usegenerate_variant_clinical_report. - Population genetics — gnomAD LOEUF / pLI gene-constraint scores. Per-variant allele frequencies and the per-ancestry breakdown are not wired into this tool.
- Disease associations — a placeholder note pointing at
get_target_diseases(); the Open Targets / MONDO traversal is a roadmap (Wave-3) item. - 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
¶
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 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 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.