参数	类型	是否必填	默认值	描述
`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`。

响应参数

参数	类型	描述
`user_mcp_list`	array	按成员组织的 MCP 使用排行列表。

user_mcp_list 数组包含以下参数：

参数	类型	描述
`email`	string	成员的邮箱。
`mcp_list`	array	该成员的 MCP 使用排行。

mcp_list 数组包含以下参数：

参数	类型	描述
`name`	string	MCP 的名称。
`use_count`	int64	在指定时间范围内，该 MCP 被使用的次数。

请求示例

{
  "start_date": "2026-01-01",
  "end_date": "2026-01-31",
  "emails": ["name@example.com"],
  "top_n": 10
}

响应示例

{
  "code": 0,
  "message": "success",
  "request_id": "req_abc123xyz",
  "data": {
    "user_mcp_list": [
      {
        "email": "name@example.com",
        "mcp_list": [
          {
            "name": "github-mcp",
            "use_count": 100
          }
        ]
      }
    ]
  }
}