# release_status

> Bản phát hành đang ở đâu: bản nháp, đang kiểm duyệt, đã duyệt, đã lên kệ hay bị từ chối (kèm lý do), và trạng thái phân phối trên từng nền tảng kèm liên…

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

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

Bản phát hành đang ở đâu: bản nháp, đang kiểm duyệt, đã duyệt, đã lên kệ hay bị từ chối (kèm lý do), và trạng thái phân phối trên từng nền tảng kèm liên kết. Xác định bản phát hành bằng release_id (từ search_catalog), UPC, ISRC của một track hoặc tên. Nếu nhiều bản phát hành khớp, công cụ trả về danh sách để chọn.

<a id="arguments"></a>

## Tham số

| Tham số | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `release_id` | integer | Không |  |
| `upc` | string | Không |  |
| `isrc` | string | Không |  |
| `title` | string | Không | Tên bản phát hành (khớp một phần). |

<a id="example-call"></a>

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

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

<a id="result"></a>

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

| Trường | Kiểu | Mô tả |
| --- | --- | --- |
| `release` | object hoặc null |  |
| `matches` | mảng object |  |
| `tracks` | mảng object |  |
| `stores` | mảng object |  |
| `store_summary` | object |  |

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.

Nguồn: https://developer.hillsmusic.com/vi/mcp/release-status/