> ## Documentation Index
> Fetch the complete documentation index at: https://docs.royaltyport.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entities

> MCP tools for browsing entities and their associations.

## list\_entities

List root entities for a project — companies, labels, publishers, or other organizations.

| Parameter       | Type    | Required | Default | Description                            |
| --------------- | ------- | -------- | ------- | -------------------------------------- |
| `projectId`     | UUID    | Yes      | -       | Project ID                             |
| `page`          | integer | No       | `1`     | Page number                            |
| `perPage`       | integer | No       | `20`    | Items per page (1–100)                 |
| `includeMerged` | boolean | No       | `false` | Include merged (deduplicated) entities |

**Sample prompt:** "List all entities in my project"

## get\_entity

Get an entity by ID with associated artists, writers, and relations.

| Parameter       | Type    | Required | Default | Description             |
| --------------- | ------- | -------- | ------- | ----------------------- |
| `entityId`      | string  | Yes      | -       | Entity ID               |
| `projectId`     | UUID    | Yes      | -       | Project ID              |
| `includeMerged` | boolean | No       | `false` | Include merged entities |

**Sample prompt:** "Get entity ent-456 with merged duplicates"