# payouts

> The client's balance with HILLS in cents (earned, held by open withdrawals, paid, adjustments, available) and its withdrawal requests, newest first (up to 200), with…

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

Tool `payouts` · Read-only · Client accounts and their team only · Role permission: `payouts.view`

The client's balance with HILLS in cents (earned, held by open withdrawals, paid, adjustments, available) and its withdrawal requests, newest first (up to 200), with their status and dates. statements gives the same balance in USD next to monthly revenue. Client accounts only.

## Arguments

No arguments.

## Example call

Assistants make this call for you; this is what goes to `https://app.hillsmusic.com/mcp` over JSON-RPC.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "payouts",
    "arguments": {}
  }
}
```

## Result

A one-line summary as text, then the same data as JSON in `structuredContent`, with these fields:

| Field | Type | Description |
| --- | --- | --- |
| `balance` | object |  |
| `environment` | `sandbox` | Sandbox keys only (zero balance, no rows). |
| `data` | array of object |  |

A refusal (no permission, not found, bad input) comes back as a tool error (`isError: true`) whose text says why.

Source: https://developer.hillsmusic.com/mcp/payouts/