> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/ask-biobox-with-claude/tools/get-entity.md).

# get\_entity — Get entity

Get entity

Get entity

## What it does

Fetch one object's full detail — the MCP equivalent of the app's object page: its graph labels (dbLabels), display name, properties, ontology concepts, every relationship type (with counts + connected classes), the graph models it RANKS in (its rank + each model's top-10 hits), the reports it is the ANCHOR of (each with that report's top-10 scoring objects), and its dashboards — resolved by its stable uuid alone.

**When to use:** you have a uuid (from a prior search\_entities hit) and want the full picture of that object (e.g. "what is ERBB4 — its labels, properties, relationships, the models it ranks in?"); you need a node's dbLabels, properties, relationship types, or the scoring models it appears in; you want what scores highest when this object is the ANCHOR (the top targets of its own reports — e.g. "top diseases for gene X"), surfaced in the `reports` collection.

**When NOT to use:** you only have a NAME, not a uuid — resolve it with search\_entities FIRST, then call this; you want the catalog of entity types in the graph (use list\_entity\_types); you want the actual neighbour nodes along one relationship type (use get\_entity\_connections).

**Parameters:**

* `uuid` — The object's stable uuid (from a search\_entities hit). The ONLY input — it resolves any object via the universal base label (no dbLabel, no elementId needed).

**Returns:** On success, the object detail: uuid, displayName, dbLabels (e.g. \["Gene","ProteinCoding"]), concepts \[{dbLabel,displayName,definition}], properties (key→value map), relationships \[{relationship,direction,total,connectedClasses}] (every rel type), graphModels (the models the object RANKS in) as a counts-first collection { total, truncated, items:\[{modelId,modelName,reportId,reportName,rank,total,score,normScore,pinnedConcept,rankedConcept,topHits\[]}] } (best-rank-first), reports (the reports the object is the ANCHOR of) as { total, truncated, items:\[{reportId,reportName,modelId,modelName,rankedConcept,topHits\[]}] } where each report's topHits are its top-10 scoring objects, and dashboards \[{uuid,displayName,description}]. Both collections cap items at 10. When the uuid resolves to no node, returns a 404 Not Found error (isError) naming the missing uuid.

## Parameters

| Parameter | Type   | Required | Description                                                                                                                                                     |
| --------- | ------ | -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `uuid`    | string | yes      | The object's stable uuid (from a search\_entities hit). The ONLY input — it resolves any object via the universal base label (no dbLabel, no elementId needed). |

## Response

```ts
{
  uuid: string;
  displayName: string | null;
  dbLabels: string[];
  concepts: Array<{
    dbLabel: string | null;
    displayName: string | null;
    definition: string | null;
  }>;
  properties: { [key: string]: unknown };
  relationships: Array<{
    relationship: string | null;
    direction: "outbound" | "incoming";
    total: number;
    connectedClasses: string[];
  }>;
  graphModels: {
    total: number;
    truncated: boolean;
    items: Array<{
      modelId: string | null;
      modelName: string | null;
      reportId: string | null;
      reportName: string | null;
      rank: number | null;
      total: number | null;
      score: number | null;
      normScore: number | null;
      pinnedConcept: {
        uuid: string | null;
        displayName: string | null;
        concept: {
          dbLabel: string | null;
          displayName: string | null;
        } | null;
      };
      rankedConcept: {
        dbLabel: string | null;
        displayName: string | null;
      } | null;
      topHits: Array<{
        uuid: string | null;
        displayName: string | null;
        dbLabels: string[];
        score: number | null;
        normScore: number | null;
      }>;
      topHitsUnavailable: boolean;
    }>;
  };
  reports: {
    total: number;
    truncated: boolean;
    items: Array<{
      reportId: string | null;
      reportName: string | null;
      modelId: string | null;
      modelName: string | null;
      rankedConcept: {
        dbLabel: string | null;
        displayName: string | null;
      } | null;
      topHits: Array<{
        uuid: string | null;
        displayName: string | null;
        dbLabels: string[];
        score: number | null;
        normScore: number | null;
      }>;
      topHitsUnavailable: boolean;
    }>;
  };
  dashboards: Array<{
    uuid: string;
    displayName: string | null;
    description: string | null;
  }>;
}
```

## Example

```json
// get_entity({"uuid":"ENSG00000178568"})
{
  "uuid": "ENSG00000178568"
}
```

Response (arrays truncated):

```json
{
  "uuid": "ENSG00000178568",
  "displayName": "ERBB4",
  "dbLabels": [
    "Gene",
    "ProteinCoding"
  ],
  "concepts": [
    {
      "dbLabel": "Gene",
      "displayName": "Gene",
      "definition": "A region (or regions) that includes all of the sequence elements necessary to encode a functional transcript. A gene may include regulatory regions, transcribed regions and/or other functional sequenc…"
    }
  ],
  "properties": {
    "symbol": "ERBB4",
    "normalized_names": [
      "erbb4",
      "erb b2 receptor tyrosine kinase 4",
      "her4",
      "… 4 more"
    ],
    "displayName": "ERBB4",
    "source": "HAVANA",
    "uuid": "ENSG00000178568",
    "synonym": "ALS19|HER4|human epidermal growth factor receptor 4|v-erb-a avian erythroblastic leukemia viral oncogene homolog-like 4|v-erb-b2 avian erythroblastic leukemia viral oncogene homolog 4",
    "strand": "-",
    "ensembl_gene_id_version": "ENSG00000178568.16",
    "HGNC": "HGNC:3432",
    "ensembl_gene_id": "ENSG00000178568",
    "assembly": "GRCh38.p14",
    "NCBI": 2066,
    "alias": [
      "ALS19",
      "HER4",
      "p180erbB4"
    ],
    "taxon": 9606,
    "end": 212538841,
    "tag": [
      "ncRNA_host"
    ],
    "band": "q34",
    "HGNC symbol": "ERBB4",
    "bxID": "ENSG00000178568",
    "summary": "This gene is a member of the Tyr protein kinase family and the epidermal growth factor receptor subfamily. It encodes a single-pass type I membrane protein with multiple cysteine rich domains, a trans…",
    "biotype": "protein_coding",
    "percentGC": 34.69,
    "level": "manually annotated loci",
    "start": 211375717,
    "chr": "2",
    "name": "erb-b2 receptor tyrosine kinase 4",
    "fullname": "erb-b2 receptor tyrosine kinase 4"
  },
  "relationships": [
    {
      "relationship": "participates in",
      "direction": "outbound",
      "total": 39,
      "connectedClasses": [
        "Pathway"
      ]
    },
    {
      "relationship": "interacts with",
      "direction": "outbound",
      "total": 141,
      "connectedClasses": [
        "Gene"
      ]
    },
    {
      "relationship": "inhibits",
      "direction": "outbound",
      "total": 1,
      "connectedClasses": [
        "Gene"
      ]
    },
    "… 37 more"
  ],
  "graphModels": {
    "total": 23,
    "truncated": true,
    "items": [
      {
        "modelId": "7oNxw84sOcCi0v8h2fn15",
        "modelName": "Neurodegenerative Target Prioritization 2",
        "reportId": "mbYRHvcGOSp4Wsl",
        "reportName": "ALS",
        "rank": 1,
        "total": 44750,
        "score": 1.1987416527906658,
        "normScore": 0.3878177499422183,
        "pinnedConcept": {
          "uuid": "MONDO:0004976",
          "displayName": null,
          "concept": {
            "dbLabel": "Disease",
            "displayName": "Disease"
          }
        },
        "rankedConcept": {
          "dbLabel": "Gene",
          "displayName": "Gene"
        },
        "topHits": [
          {
            "uuid": "ENSG00000178568",
            "displayName": "ERBB4",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.1987416527906658,
            "normScore": 0.3878177499422183
          },
          {
            "uuid": "ENSG00000142168",
            "displayName": "SOD1",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.1703652478246818,
            "normScore": 0.37863739527635865
          },
          {
            "uuid": "ENSG00000120948",
            "displayName": "TARDBP",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.1694105832942776,
            "normScore": 0.3783285415302082
          },
          "… 7 more"
        ],
        "topHitsUnavailable": false
      },
      {
        "modelId": "7oNxw84sOcCi0v8h2fn15",
        "modelName": "Neurodegenerative Target Prioritization 2",
        "reportId": "-QN55UpMrzD1ySgNXqkeS",
        "reportName": "ALS",
        "rank": 1,
        "total": 44750,
        "score": 1.1987416527906658,
        "normScore": 0.3878177499422183,
        "pinnedConcept": {
          "uuid": "MONDO:0004976",
          "displayName": null,
          "concept": {
            "dbLabel": "Disease",
            "displayName": "Disease"
          }
        },
        "rankedConcept": {
          "dbLabel": "Gene",
          "displayName": "Gene"
        },
        "topHits": [
          {
            "uuid": "ENSG00000178568",
            "displayName": "ERBB4",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.3274501206893674,
            "normScore": 0.38233344309755046
          },
          {
            "uuid": "ENSG00000142168",
            "displayName": "SOD1",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.2744593333074645,
            "normScore": 0.3670709862440668
          },
          {
            "uuid": "ENSG00000112367",
            "displayName": "FIG4",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.2692667919542173,
            "normScore": 0.3655754255574005
          },
          "… 7 more"
        ],
        "topHitsUnavailable": false
      },
      {
        "modelId": "Ok8nsoMnRLWiC_YByOslb",
        "modelName": "Neurodegenerative Target Prioritization + Pathways",
        "reportId": "CR-Ksa7pFW1SOnDyPQ0kd",
        "reportName": "ALS",
        "rank": 1,
        "total": 44750,
        "score": 1.3274501206893674,
        "normScore": 0.36858877328971584,
        "pinnedConcept": {
          "uuid": "MONDO:0004976",
          "displayName": null,
          "concept": {
            "dbLabel": "Disease",
            "displayName": "Disease"
          }
        },
        "rankedConcept": {
          "dbLabel": "Gene",
          "displayName": "Gene"
        },
        "topHits": [
          {
            "uuid": "ENSG00000178568",
            "displayName": "ERBB4",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.3274501206893674,
            "normScore": 0.36858877328971584
          },
          {
            "uuid": "ENSG00000142168",
            "displayName": "SOD1",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.2744593333074645,
            "normScore": 0.3538749930788191
          },
          {
            "uuid": "ENSG00000112367",
            "displayName": "FIG4",
            "dbLabels": [
              "Gene",
              "ProteinCoding"
            ],
            "score": 1.2692667919542173,
            "normScore": 0.35243319694816255
          },
          "… 7 more"
        ],
        "topHitsUnavailable": false
      },
      "… 7 more"
    ]
  },
  "reports": {
    "total": 1,
    "truncated": false,
    "items": [
      {
        "reportId": "o3kQhTgwg5bOFnzLgBx-C",
        "reportName": "ERBB4",
        "modelId": "Ma_CdQA9B2m8lPLj3VNNv",
        "modelName": "ALS Asset Prioritization",
        "rankedConcept": {
          "dbLabel": "Drug",
          "displayName": "Drug"
        },
        "topHits": [
          {
            "uuid": "CHEMBL1173655",
            "displayName": "AFATINIB",
            "dbLabels": [
              "Drug",
              "SmallMolecule"
            ],
            "score": 0.20505577519871201,
            "normScore": 0.16603706493822834
          },
          {
            "uuid": "CHEMBL1645462",
            "displayName": "AC-480",
            "dbLabels": [
              "Drug",
              "SmallMolecule"
            ],
            "score": 0.20505577519871201,
            "normScore": 0.16603706493822834
          },
          {
            "uuid": "CHEMBL180022",
            "displayName": "NERATINIB",
            "dbLabels": [
              "Drug",
              "SmallMolecule"
            ],
            "score": 0.20505577519871201,
            "normScore": 0.16603706493822834
          },
          "… 7 more"
        ],
        "topHitsUnavailable": false
      }
    ]
  },
  "dashboards": []
}
```