Mondo through GeneFoundry
Resolve disease terminology and inspect Mondo hierarchy and cross-ontology mappings.
- Research area
- Ontologies
- Namespace
mondo- Listed tools
- 13
- Upstream source
- Mondo
Research tasks
- Resolve a disease name to a MONDO concept
- Compare disease cross-references and mapping predicates
Start with tool discovery
The catalog lists mondo_resolve_disease as a representative tool. After connecting your client, inspect the tools and input requirements returned by the service before submitting a query.
Identifiers to prepare
- Disease label or synonym
- MONDO identifier
- External disease CURIE
All available tools (13)
The router surfaces these tools namespaced under mondo_*:
get_server_capabilitiesReturn the mondo-link discovery surface: identity/build/Mondo release, the tool list WITH call signatures, response modes, recommended workflows, the cross-reference predicate ranking, the error taxonomy, and limits. detail='full' adds the full policy notes. Call this first in a cold session, or read mondo://tools / mondo://capabilities. Signature: get_server_capabilities(detail=).
Return the mondo-link discovery surface: identity/build/Mondo release, the tool list WITH call signatures, response modes, recommended workflows, the cross-reference predicate ranking, the error taxonomy, and limits. detail='full' adds the full policy notes. Call this first in a cold session, or read mondo://tools / mondo://capabilities. Signature: get_server_capabilities(detail=).
Input parameters
detail(string) — summary (default, light) or full (adds policy notes).
get_diagnosticsReport the local Mondo index status: whether the data is built, the loaded Mondo release version, term/obsolete/xref/closure counts, schema version, and when it was built, plus a runtime block (request/error counts and latency percentiles p50/p95/p99). Use this to confirm freshness or diagnose an upstream_unavailable error. Signature: get_diagnostics().
Report the local Mondo index status: whether the data is built, the loaded Mondo release version, term/obsolete/xref/closure counts, schema version, and when it was built, plus a runtime block (request/error counts and latency percentiles p50/p95/p99). Use this to confirm freshness or diagnose an upstream_unavailable error. Signature: get_diagnostics().
resolve_diseaseResolve a disease label, synonym, MONDO id, or external cross-reference CURIE (OMIM/Orphanet/DOID/...) to the canonical Mondo term {mondo_id, name, match_type}. A near-miss or acronym-like label falls back to a conservative fuzzy match (match_type='fuzzy'); an ambiguous label returns ambiguous_query with candidates; an obsolete id returns not_found with its successor. Signature: resolve_disease(query, response_mode=).
Resolve a disease label, synonym, MONDO id, or external cross-reference CURIE (OMIM/Orphanet/DOID/...) to the canonical Mondo term {mondo_id, name, match_type}. A near-miss or acronym-like label falls back to a conservative fuzzy match (match_type='fuzzy'); an ambiguous label returns ambiguous_query with candidates; an obsolete id returns not_found with its successor. Signature: resolve_disease(query, response_mode=).
Input parameters
query(string) [required] — A disease label, synonym, a MONDO id (MONDO:0008426 or 0008426), or a cross-reference CURIE (OMIM:182212, Orphanet:2462, DOID:...).response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).
search_diseasesFull-text search over Mondo disease names, synonyms, and definitions (FTS, relevance-ranked). Returns {mondo_id, name, score} -- compact adds a short definition_snippet; standard/full add the complete definition -- plus a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset advanced) and a widen step. Obsolete terms are excluded unless include_obsolete=true. Signature: search_diseases(query, limit=, offset=, include_obsolete=, response_mode=).
Full-text search over Mondo disease names, synonyms, and definitions (FTS, relevance-ranked). Returns {mondo_id, name, score} -- compact adds a short definition_snippet; standard/full add the complete definition -- plus a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset advanced) and a widen step. Obsolete terms are excluded unless include_obsolete=true. Signature: search_diseases(query, limit=, offset=, include_obsolete=, response_mode=).
Input parameters
include_obsolete(boolean) — Include obsolete terms (default false).limit(integer) — Max hits (default 25).offset(integer) — Rows to skip for forward paging (default 0).query(string) [required] — A disease label, synonym, a MONDO id (MONDO:0008426 or 0008426), or a cross-reference CURIE (OMIM:182212, Orphanet:2462, DOID:...).response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).
get_diseaseReturn a Mondo disease term: definition, synonyms, grouped cross-references, direct parents and children, top-level groupings, subsets, and obsolescence (replaced_by/consider). The term accepts a MONDO id, a label/synonym, or an external xref CURIE (resolved first). Pass fields=['xrefs.OMIM', ...] for a sparse projection. Signature: get_disease(term, response_mode=, fields=).
Return a Mondo disease term: definition, synonyms, grouped cross-references, direct parents and children, top-level groupings, subsets, and obsolescence (replaced_by/consider). The term accepts a MONDO id, a label/synonym, or an external xref CURIE (resolved first). Pass fields=['xrefs.OMIM', ...] for a sparse projection. Signature: get_disease(term, response_mode=, fields=).
Input parameters
fields(any) — Sparse fieldset: return ONLY these top-level keys (dot into a grouped object, e.g. 'xrefs.OMIM'). Identity anchors (mondo_id, name, mondo_version) are always included. Omit for the full payload.response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
get_disease_ancestorsReturn all transitive is_a ancestors (broader diseases) of a Mondo term via the precomputed closure, with a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset) so you can walk a >limit closure without re-sending rows. Use get_disease_parents for only the immediate parents. Signature: get_disease_ancestors(term, limit=, offset=, response_mode=).
Return all transitive is_a ancestors (broader diseases) of a Mondo term via the precomputed closure, with a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset) so you can walk a >limit closure without re-sending rows. Use get_disease_parents for only the immediate parents. Signature: get_disease_ancestors(term, limit=, offset=, response_mode=).
Input parameters
limit(integer) — Max rows returned (default 200).offset(integer) — Rows to skip for forward paging (default 0).response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
get_disease_descendantsReturn all transitive is_a descendants (more specific diseases) of a Mondo term via the precomputed closure, with a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset) so you can walk a >limit closure without re-sending rows. Use get_disease_children for only the immediate children. Signature: get_disease_descendants(term, limit=, offset=, response_mode=).
Return all transitive is_a descendants (more specific diseases) of a Mondo term via the precomputed closure, with a pagination block {total, returned, limit, offset, truncated, next_offset}. When truncated, next_commands carries a forward-page step (offset) so you can walk a >limit closure without re-sending rows. Use get_disease_children for only the immediate children. Signature: get_disease_descendants(term, limit=, offset=, response_mode=).
Input parameters
limit(integer) — Max rows returned (default 200).offset(integer) — Rows to skip for forward paging (default 0).response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
get_disease_parentsReturn the direct is_a parents (immediate broader diseases) of a Mondo term. Use get_disease_ancestors for the full transitive set. Signature: get_disease_parents(term, response_mode=).
Return the direct is_a parents (immediate broader diseases) of a Mondo term. Use get_disease_ancestors for the full transitive set. Signature: get_disease_parents(term, response_mode=).
Input parameters
response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
get_disease_childrenReturn the direct is_a children (immediate more-specific diseases) of a Mondo term. Use get_disease_descendants for the full transitive set. Signature: get_disease_children(term, response_mode=).
Return the direct is_a children (immediate more-specific diseases) of a Mondo term. Use get_disease_descendants for the full transitive set. Signature: get_disease_children(term, response_mode=).
Input parameters
response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
resolve_xrefResolve an external cross-reference CURIE (OMIM/Orphanet/DOID/NCIT/UMLS/MeSH/MedGen/SNOMED/GARD) back to the Mondo term(s) that map to it, ranked by mapping predicate (exactMatch > equivalentTo > closeMatch > ...). Returns matches[] plus a pagination block {total, returned, limit, offset, truncated, next_offset}; when truncated, next_commands carries a forward-page step (offset). Signature: resolve_xref(xref_id, limit=, offset=, response_mode=).
Resolve an external cross-reference CURIE (OMIM/Orphanet/DOID/NCIT/UMLS/MeSH/MedGen/SNOMED/GARD) back to the Mondo term(s) that map to it, ranked by mapping predicate (exactMatch > equivalentTo > closeMatch > ...). Returns matches[] plus a pagination block {total, returned, limit, offset, truncated, next_offset}; when truncated, next_commands carries a forward-page step (offset). Signature: resolve_xref(xref_id, limit=, offset=, response_mode=).
Input parameters
limit(integer) — Max matches (default 50).offset(integer) — Rows to skip for forward paging (default 0).response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).xref_id(string) [required] — An external cross-reference CURIE (prefix:local), e.g. OMIM/Orphanet/DOID, to resolve back to the Mondo term(s) that map to it.
map_cross_ontologyList a Mondo term's cross-references to other ontologies, grouped by target prefix. get_disease surfaces every source; this tool's `prefixes` filter is the first-class set (OMIM/ORPHA/DOID/NCIT/UMLS/MESH/MEDGEN/SCTID/GARD), each with its mapping predicate and origin (obo_xref|sssom). An unrecognised prefix is rejected with invalid_input. Signature: map_cross_ontology(term, prefixes=, response_mode=).
List a Mondo term's cross-references to other ontologies, grouped by target prefix. get_disease surfaces every source; this tool's `prefixes` filter is the first-class set (OMIM/ORPHA/DOID/NCIT/UMLS/MESH/MEDGEN/SCTID/GARD), each with its mapping predicate and origin (obo_xref|sssom). An unrecognised prefix is rejected with invalid_input. Signature: map_cross_ontology(term, prefixes=, response_mode=).
Input parameters
prefixes(any) — Restrict to these first-class cross-reference sources (OMIM/ORPHA/DOID/NCIT/UMLS/MESH/MEDGEN/SCTID/GARD). An unrecognised prefix is rejected with invalid_input. Omit to return every source.response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).term(string) [required] — A MONDO id (MONDO:0008426 or 0008426), a disease label/synonym, or an external xref CURIE that resolves to a single Mondo term.
resolve_disease_batchResolve many labels/ids/xrefs in one call (partial success: each item returns its resolution {mondo_id, name, match_type} or its own ok=false/error_code/message; the call never fails wholesale). Every row carries its `index` (0-based, 1:1 with the input) so results key back uniformly regardless of ok. Max 50 items; compact per item. Signature: resolve_disease_batch(queries, response_mode=).
Resolve many labels/ids/xrefs in one call (partial success: each item returns its resolution {mondo_id, name, match_type} or its own ok=false/error_code/message; the call never fails wholesale). Every row carries its `index` (0-based, 1:1 with the input) so results key back uniformly regardless of ok. Max 50 items; compact per item. Signature: resolve_disease_batch(queries, response_mode=).
Input parameters
queries(array) [required] — 1..50 disease labels/synonyms, MONDO ids, or xref CURIEs.response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).
get_disease_batchFetch many disease records in one call (partial success per item: each row is the record or its own ok=false/error_code/message). Each term accepts a MONDO id, label, or xref CURIE; pass fields=[...] for a sparse projection. Every row carries its `index` (0-based, 1:1 with the input). Max 50 items; compact per item. Signature: get_disease_batch(terms, response_mode=, fields=).
Fetch many disease records in one call (partial success per item: each row is the record or its own ok=false/error_code/message). Each term accepts a MONDO id, label, or xref CURIE; pass fields=[...] for a sparse projection. Every row carries its `index` (0-based, 1:1 with the input). Max 50 items; compact per item. Signature: get_disease_batch(terms, response_mode=, fields=).
Input parameters
fields(any) — Sparse fieldset: return ONLY these top-level keys (dot into a grouped object, e.g. 'xrefs.OMIM'). Identity anchors (mondo_id, name, mondo_version) are always included. Omit for the full payload.response_mode(string) — Verbosity: minimal|compact|standard|full (default compact).terms(array) [required] — 1..50 MONDO ids, disease labels/synonyms, or xref CURIEs.
Database & release provenance
- Data mode
upstream-live- Attestation
- live-upstream
- Data release tag
observed-2026.07.13- Release version
v0.4.5
sha256:c588ebf0141f1cf8cb30bbc0a0ef545dc12045402ddaaf7e4ecc4d1b236a9191ghcr.io/berntpopp/mondo-link@sha256:7ade14a2432b00c9a52749e0e4ef7d3d048b7044be6dcff6562b2ebe96845975Review the response
Keep the source record link and submitted identifiers with your notes. Record the dataset version and retrieval date when available. This page does not contain a captured Mondo response.