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

# Artists

> MCP tools for browsing recording artists.

## list\_artists

List root artists for a project — performers linked to recordings.

| 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 artists |

**Sample prompt:** "Show me all artists in the project"

## get\_artist

Get an artist by ID.

| Parameter       | Type    | Required | Default | Description            |
| --------------- | ------- | -------- | ------- | ---------------------- |
| `artistId`      | string  | Yes      | -       | Artist ID              |
| `projectId`     | UUID    | Yes      | -       | Project ID             |
| `includeMerged` | boolean | No       | `false` | Include merged artists |

**Sample prompt:** "Get details for artist art-789"