> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trae.cn/llms.txt
> Use this file to discover all available pages before exploring further.

获取指定时间范围内，企业整体的 MCP 使用排行。
## 所需权限 {#ddaad5fa}
`statistics`
## 请求方式 {#a3c3aeff}
```HTTP
GET /openapi/v1/statistics/mcp
```

## 请求参数 {#884ecd79}
<!-- @cols-width: 146,146,100,146,320 -->
| | | | | | \
|**参数** |**类型** |**是否必填** |**默认值** |**描述** |
|---|---|---|---|---|
| | | | | | \
|`start_date` |string |是 |\- |开始日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`end_date` |string |是 |\- |结束日期。格式：YYYY-MM-DD。 |
| | | | | | \
|`timezone` |string |否 |`"Asia/Shanghai"` |时区。需使用 IANA 时区名称。 |
| | | | | | \
|`top_n` |int |否 |`20` |指定返回使用量排行前 `top_n` 的 MCP。取值范围：`1` ~ `100`。 |

## 响应参数 {#073cedcc}
<!-- @cols-width: 146,144,320 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`mcp_list` |array |MCP 使用排行列表。 |

`mcp_list` 数组包含以下参数：
<!-- @cols-width: 146,144,320 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`name` |string |MCP 的名称。 |
| | | | \
|`use_count` |int64 |该 MCP 被使用的次数。 |

## 请求示例 {#0fa57ec7}
```Bash
curl -X GET "https://{domain}/openapi/v1/statistics/mcp?start_date=2026-01-01&end_date=2026-01-31" \
  -H "Authorization: Bearer {access_token}"
```

## 响应示例 {#ddc2a791}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "mcp_list": [
      {
        "name": "github-mcp",
        "use_count": 1500
      }
    ]
  }
}
```