statements

Công cụ statements · Chỉ đọc · Mọi tài khoản có quyền truy cập MCP · Quyền vai trò: royalties.view, payouts.view

Sao kê hằng tháng (doanh thu và lượt nghe mỗi tháng), số dư và thanh toán. Khách hàng và nghệ sĩ/hãng đĩa trực tiếp: số dư tại HILLS và các lần rút tiền. Nghệ sĩ/hãng đĩa thuộc một khách hàng: số tiền khách hàng đã trả cho họ; phần của họ, các khoản thanh toán đang xử lý và số khách hàng còn nợ chỉ hiển thị khi khách hàng cho nghệ sĩ xem số dư. Nhân viên HILLS: sao kê của một tài khoản theo account_id (royalties.view; số dư và thanh toán với payouts.view), hoặc nếu không có account_id thì là các lần nhập sao kê nền tảng gần đây.

Tham số

Ví dụ lệnh gọi

Trợ lý AI thực hiện lệnh gọi này thay bạn; đây là nội dung được gửi đến https://mcp.hillsmusic.com qua JSON-RPC.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "statements",
    "arguments": {
      "months": 12
    }
  }
}

Kết quả

Một dòng tóm tắt dạng văn bản, sau đó là cùng dữ liệu đó dạng JSON trong structuredContent, với các trường sau:

Một lời từ chối (không có quyền, không tìm thấy, dữ liệu đầu vào sai) được trả về dưới dạng lỗi công cụ (isError: true), kèm văn bản giải thích lý do.