> ## 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 使用排行。
## 所需权限 {#d3fe5bab}
`statistics`
## 请求方式 {#366d5c61}
```HTTP
POST /openapi/v1/statistics/user-mcp
```

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

## 响应参数 {#0c7f45d1}
<!-- @cols-width: 153,100,349 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`user_mcp_list` |array |按成员组织的 MCP 使用排行列表。 |

`user_mcp_list` 数组包含以下参数：
<!-- @cols-width: 111,100,349 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`email` |string |成员的邮箱。 |
| | | | \
|`mcp_list` |array |该成员的 MCP 使用排行。 |

`mcp_list` 数组包含以下参数：
<!-- @cols-width: 114,100,350 -->
| | | | \
|**参数** |**类型** |**描述** |
|---|---|---|
| | | | \
|`name` |string |MCP 的名称。 |
| | | | \
|`use_count` |int64 |在指定时间范围内，该 MCP 被使用的次数。 |

## 请求示例 {#84f52d9f}
```JSON
{
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "emails": ["name@example.com"],
  "top_n": 10
}
```

## 响应示例 {#53bf39d6}
```JSON
{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "user_mcp_list": [
      {
        "email": "name@example.com",
        "mcp_list": [
          {
            "name": "github-mcp",
            "use_count": 100
          }
        ]
      }
    ]
  }
}
```