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

# Compositions

> MCP tools for browsing compositions.

## list\_compositions

List compositions for a project — musical works identified by ISWC codes.

| 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)      |
| `includeProducts` | boolean | No       | `false` | Include associated products |

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

## get\_composition

Get a composition by ID with ISWC and linked writers.

| Parameter         | Type    | Required | Default | Description                 |
| ----------------- | ------- | -------- | ------- | --------------------------- |
| `compositionId`   | string  | Yes      | -       | Composition ID              |
| `projectId`       | UUID    | Yes      | -       | Project ID                  |
| `includeProducts` | boolean | No       | `false` | Include associated products |

**Sample prompt:** "Get composition comp-222"