Skip to content
HILLS API v1 Early access

MCP server

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…

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.

{
  "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.

Ready to integrate?

Request API access and we get back to you within 1–3 business days.