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

# Relations

> MCP tools for browsing contacts and people.

## list\_relations

List root relations for a project — contacts and people such as managers, A\&R, and lawyers.

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

**Sample prompt:** "Show all contacts in the project"

## get\_relation

Get a relation by ID.

| Parameter       | Type    | Required | Default | Description              |
| --------------- | ------- | -------- | ------- | ------------------------ |
| `relationId`    | string  | Yes      | -       | Relation ID              |
| `projectId`     | UUID    | Yes      | -       | Project ID               |
| `includeMerged` | boolean | No       | `false` | Include merged relations |

**Sample prompt:** "Get relation rel-654"