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

# Contracts

> MCP tools for browsing contracts and their extracted data.

## list\_contracts

List contracts for a project. Use `includes` to embed extracted sub-resource data inline.

| 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)   |
| `includes`  | string\[] | No       | -       | Sub-resources to include |

**Valid includes:** `entities`, `artists`, `writers`, `royalties`, `splits`, `costs`, `compensations`, `dates`, `accounting-periods`, `types`, `signatures`, `control-areas`, `creative-approvals`, `balances`, `recordings`, `compositions`, `relations`

**Sample prompt:** "List all contracts with their royalty terms"

## get\_contract

Get a contract by ID with optional sub-resource includes.

| Parameter    | Type      | Required | Default | Description                                   |
| ------------ | --------- | -------- | ------- | --------------------------------------------- |
| `contractId` | string    | Yes      | -       | Contract ID                                   |
| `projectId`  | UUID      | Yes      | -       | Project ID                                    |
| `includes`   | string\[] | No       | -       | Sub-resources to include (same list as above) |

**Sample prompt:** "Get contract abc-123 with entities and dates"