Monarch V3 Tools

Configuration File: monarch_v3_tools.json Tool Type: Local Tools Count: 6

This page contains all tools defined in the monarch_v3_tools.json configuration file.

Available Tools

MonarchV3_get_associations (Type: MonarchV3Tool)

Query cross-species associations between biomedical entities in the Monarch Initiative knowledge …

MonarchV3_get_associations tool specification

Tool Information:

  • Name: MonarchV3_get_associations

  • Type: MonarchV3Tool

  • Description: Query cross-species associations between biomedical entities in the Monarch Initiative knowledge graph. Find gene-phenotype, disease-phenotype, gene-disease, or gene-pathway associations. Uses Biolink model categories to specify association type. Integrates data from OMIM, ClinVar, HPO, MGI, ZFIN, FlyBase, WormBase. Example: HGNC:11998 (TP53) with category GeneToPhenotypicFeatureAssociation returns phenotypes like hepatocellular carcinoma and reticular hyperpigmentation.

Parameters:

  • subject (string) (required) Subject entity CURIE. Examples: ‘HGNC:11998’ (TP53), ‘MONDO:0005148’ (type 2 diabetes), ‘HP:0001250’ (seizure).

  • category (string) (required) Biolink association category. Options: ‘biolink:GeneToPhenotypicFeatureAssociation’ (gene->phenotypes), ‘biolink:DiseaseToPhenotypicFeatureAssociation’ (disease->phenotypes), ‘biolink:CorrelatedGeneToDiseaseAssociation’ (gene->diseases, correlated), ‘biolink:CausalGeneToDiseaseAssociation’ (gene->diseases, causal), ‘biolink:GeneToPathwayAssociation’ (gene->pathways), ‘biolink:VariantToDiseaseAssociation’ (variant->diseases), ‘biolink:GeneToExpressionSiteAssociation’ (gene->expression sites/tissues).

  • limit (integer) (optional) Maximum number of associations to return (default: 20, max: 200).

Example Usage:

query = {
    "name": "MonarchV3_get_associations",
    "arguments": {
        "subject": "example_value",
        "category": "example_value"
    }
}
result = tu.run(query)

MonarchV3_get_entity (Type: MonarchV3Tool)

Look up detailed information about any biomedical entity in the Monarch Initiative knowledge grap…

MonarchV3_get_entity tool specification

Tool Information:

  • Name: MonarchV3_get_entity

  • Type: MonarchV3Tool

  • Description: Look up detailed information about any biomedical entity in the Monarch Initiative knowledge graph by its CURIE identifier. Supports genes (HGNC), diseases (MONDO, OMIM), phenotypes (HP), variants, and more. Returns the entity name, category, description, synonyms, cross-references, and species. Example: HGNC:11998 returns TP53 gene with cross-refs to ENSEMBL, OMIM; MONDO:0005148 returns type 2 diabetes mellitus with detailed description.

Parameters:

  • entity_id (string) (required) Entity CURIE identifier. Examples: ‘HGNC:11998’ (TP53), ‘HGNC:1100’ (BRCA1), ‘MONDO:0005148’ (type 2 diabetes), ‘HP:0001250’ (seizure), ‘OMIM:191170’ (Li-Fraumeni syndrome).

Example Usage:

query = {
    "name": "MonarchV3_get_entity",
    "arguments": {
        "entity_id": "example_value"
    }
}
result = tu.run(query)

MonarchV3_get_histopheno (Type: MonarchV3Tool)

Get the phenotype profile of a disease grouped by body system from the Monarch Initiative. Return…

MonarchV3_get_histopheno tool specification

Tool Information:

  • Name: MonarchV3_get_histopheno

  • Type: MonarchV3Tool

  • Description: Get the phenotype profile of a disease grouped by body system from the Monarch Initiative. Returns counts of phenotypic features (HPO terms) organized by anatomical system (e.g., nervous_system, skeletal_system, eye, cardiovascular_system). Only systems with at least one phenotype are returned, sorted by count descending. Useful for understanding which organ systems are most affected by a disease. Example: MONDO:0007947 (Marfan syndrome) returns high counts for head_neck (58), musculature (58), skeletal_system (56), eye (31).

Parameters:

  • entity_id (string) (required) Disease CURIE identifier. Examples: ‘MONDO:0007947’ (Marfan syndrome), ‘MONDO:0005148’ (type 2 diabetes), ‘MONDO:0004975’ (Alzheimer disease), ‘MONDO:0005015’ (diabetes mellitus).

Example Usage:

query = {
    "name": "MonarchV3_get_histopheno",
    "arguments": {
        "entity_id": "example_value"
    }
}
result = tu.run(query)

MonarchV3_get_mappings (Type: MonarchV3Tool)

Get cross-ontology mappings for a biomedical entity from the Monarch Initiative. Returns equivale…

MonarchV3_get_mappings tool specification

Tool Information:

  • Name: MonarchV3_get_mappings

  • Type: MonarchV3Tool

  • Description: Get cross-ontology mappings for a biomedical entity from the Monarch Initiative. Returns equivalence mappings between ontology identifiers, such as MONDO to OMIM, ICD10, SNOMED CT, NCIT, MESH, DOID, and Orphanet. Useful for translating disease identifiers across coding systems (e.g., for clinical data integration, ICD-10 billing codes, or linking to OMIM entries). Example: MONDO:0005148 (type 2 diabetes) maps to ICD10CM:E11, DOID:9352, OMIM:125853, MESH:D003924.

Parameters:

  • entity_id (string) (required) Entity CURIE identifier to find mappings for. Examples: ‘MONDO:0005148’ (type 2 diabetes), ‘MONDO:0007947’ (Marfan syndrome), ‘HP:0001250’ (seizure).

  • limit (integer) (optional) Maximum number of mappings to return (default: 20, max: 100).

Example Usage:

query = {
    "name": "MonarchV3_get_mappings",
    "arguments": {
        "entity_id": "example_value"
    }
}
result = tu.run(query)

MonarchV3_phenotype_similarity_search (Type: MonarchV3Tool)

Find diseases that best match a set of phenotypes (HPO terms) using semantic similarity from the …

MonarchV3_phenotype_similarity_search tool specification

Tool Information:

  • Name: MonarchV3_phenotype_similarity_search

  • Type: MonarchV3Tool

  • Description: Find diseases that best match a set of phenotypes (HPO terms) using semantic similarity from the Monarch Initiative. Given a patient phenotype profile as a list of HPO IDs, returns diseases ranked by phenotype overlap score. Uses information content-based similarity (AncestorInformationContent metric). Essential for rare disease differential diagnosis: input observed phenotypes, get ranked candidate diseases. Example: [HP:0001250 (seizure), HP:0001249 (intellectual disability), HP:0002353 (EEG abnormality)] returns diseases like intellectual disability AR 31, Dravet syndrome ranked by semantic similarity score.

Parameters:

  • phenotypes (array) (required) List of HPO term CURIEs representing observed phenotypes. Examples: [‘HP:0001250’, ‘HP:0001249’, ‘HP:0002353’] for seizure + intellectual disability + EEG abnormality.

  • group (string) (optional) Entity group to search against. Default: ‘Human Diseases’. Options: ‘Human Diseases’, ‘Mouse’, ‘Rat’, ‘Zebrafish’, ‘C. elegans’, ‘Drosophila’.

  • limit (integer) (optional) Maximum number of matching diseases to return (default: 10, max: 50).

Example Usage:

query = {
    "name": "MonarchV3_phenotype_similarity_search",
    "arguments": {
        "phenotypes": ["item1", "item2"]
    }
}
result = tu.run(query)

MonarchV3_search (Type: MonarchV3Tool)

Search the Monarch Initiative knowledge graph for biomedical entities by name or keyword. Returns…

MonarchV3_search tool specification

Tool Information:

  • Name: MonarchV3_search

  • Type: MonarchV3Tool

  • Description: Search the Monarch Initiative knowledge graph for biomedical entities by name or keyword. Returns genes, diseases, phenotypes, and other entities matching the query, with their CURIE identifiers and categories. Useful for finding entity IDs to use with MonarchV3_get_entity and MonarchV3_get_associations. Example: searching ‘BRCA1’ returns HGNC:1100 (gene), ‘Alzheimer’ returns MONDO disease entries.

Parameters:

  • query (string) (optional) Search query. Can be gene names, disease names, phenotype terms, etc. Examples: ‘BRCA1’, ‘breast cancer’, ‘seizure’, ‘insulin resistance’.

  • limit (integer) (optional) Maximum results to return (default: 10, max: 50).

  • category (string) (optional) Filter by entity category. Options: ‘biolink:Gene’, ‘biolink:Disease’, ‘biolink:PhenotypicFeature’, ‘biolink:NamedThing’. Default: all categories.

  • q (string) (optional) Alias for query parameter.

Example Usage:

query = {
    "name": "MonarchV3_search",
    "arguments": {
    }
}
result = tu.run(query)