Skip to content
HILLS API v1 Early access

MCP server

requests

Open platform requests and what each is waiting on: YouTube Official Artist Channel (OAC) requests and withdrawals (payout requests).

Tool requests · Read-only · Every account with MCP access · Role permission: requests.view, payouts.view

Open platform requests and what each is waiting on: YouTube Official Artist Channel (OAC) requests and withdrawals (payout requests). Staff see the queues their role opens (requests.view, payouts.view).

Arguments

Argument Type Required Description
status open | closed | all No Default “open”.
type all | youtube_oac | payout No Default “all”.
limit integer (1–100) No Default 50.

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": "requests",
    "arguments": {
      "status": "open",
      "type": "all",
      "limit": 50
    }
  }
}

Result

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

Field Type Description
requests array of object
note string

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.