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:c588ebf0141f1cf8cb30bbc0a0ef545dc12045402ddaaf7e4ecc4d1b236a9191
ghcr.io/berntpopp/mondo-link@sha256:7ade14a2432b00c9a52749e0e4ef7d3d048b7044be6dcff6562b2ebe96845975

Review 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.