diff --git a/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md b/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md
index 3d5d674..0ee41f4 100644
--- a/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md
+++ b/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md
@@ -1057,7 +1057,7 @@
 
 ## 44. agent.user.list.query
 
-代理角色用户分页查询（m0 `user`，强制 `enterprise_type=1` + `soft_delete=0`），对应老 `/user/listByPage` 的代理用户子集。
+员工查询（代理人员查询）：代理角色用户分页查询（m0 `user`，强制 `enterprise_type=1` + `soft_delete=0`），对应老 `/user/listByPage` 的代理用户子集。
 
 - 分类：agent ｜ 类型：读
 - 入参（全部可选）：`agentId`（精确，必须在当前身份可见范围内）、`name`/`mobile`/`no`（模糊）、
diff --git a/xiaoqu-agent-service/doc/agent-user-list-mcp-tool-design.md b/xiaoqu-agent-service/doc/agent-user-list-mcp-tool-design.md
index dc78a7f..028a150 100644
--- a/xiaoqu-agent-service/doc/agent-user-list-mcp-tool-design.md
+++ b/xiaoqu-agent-service/doc/agent-user-list-mcp-tool-design.md
@@ -33,7 +33,7 @@
 
 ## 3. 工具契约
 
-**`agent.user.list.query`**（category=`agent`，kind=read）——分页查询代理角色用户（`enterprise_type=1`）列表，返回所属权限组、部门岗位明细。（v3 拍板：不返回位置信息）
+**`agent.user.list.query`**（category=`agent`，kind=read）——员工查询（代理人员查询）：分页查询代理角色用户（`enterprise_type=1`）列表，返回所属权限组、部门岗位明细。（v3 拍板：不返回位置信息；v4 拍板：工具描述定位为"员工查询/代理人员查询"）
 
 ### 入参
 
diff --git a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/AgentUserTools.java b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/AgentUserTools.java
index a30a51f..c5b5702 100644
--- a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/AgentUserTools.java
+++ b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/AgentUserTools.java
@@ -64,7 +64,7 @@ public class AgentUserTools implements ToolObject {
      * agentName/authorityName/districtName/deptList 按页批量 IN 富化，无 N+1。
      */
     @XqTool(category = "agent", kind = "read")
-    @Tool(name = "agent.user.list.query", description = "分页查询代理角色用户（user.enterprise_type=1）列表，返回所属权限组、部门岗位明细。"
+    @Tool(name = "agent.user.list.query", description = "员工查询（代理人员查询）：分页查询代理角色用户（user.enterprise_type=1）列表，返回所属权限组、部门岗位明细。"
             + "行级权限：总部身份（权限组 isagent=0）可看全部，可传任意 agentId；代理商身份（isagent=1）只能看自己+直属下级+授权代管代理商范围内的用户，"
             + "传 agentId 时必须在可见范围内，否则拒绝。"
             + "enterpriseType 含义：1=代理 2=物业（本工具恒为 1）；approle 含义：1=运维 2=保洁 3=富士康 4=老化 5=物业 6=代理；"