diff --git a/internal/agent/tools/list_mcp_resources.md b/internal/agent/tools/list_mcp_resources.md
index ee2695d0d775b060696e11e80281ed4e2d3dd7c6..774d8e6f0b74d1b78fa9af7a82bfc3982c2a7bbb 100644
--- a/internal/agent/tools/list_mcp_resources.md
+++ b/internal/agent/tools/list_mcp_resources.md
@@ -1,4 +1,4 @@
-Lists available resources from an MCP server.
+List available resource URIs from an MCP server by name; use before read_mcp_resource.
 
 <when_to_use>
 Use this tool to discover which resources are available before reading them.
diff --git a/internal/agent/tools/read_mcp_resource.md b/internal/agent/tools/read_mcp_resource.md
index 72cb82bf22a926f1f21958d396359b54a73ec9c8..a350395d0955a5e5e15288cfe4803f61c7bc68c6 100644
--- a/internal/agent/tools/read_mcp_resource.md
+++ b/internal/agent/tools/read_mcp_resource.md
@@ -1,4 +1,4 @@
-Reads a resource from an MCP server and returns its contents.
+Read a resource by URI from an MCP server; returns text content.
 
 <when_to_use>
 Use this tool to fetch a specific resource URI exposed by an MCP server.