From 4fe6ff42291343247d8f69ec73712b726eaa8040 Mon Sep 17 00:00:00 2001
From: Christian Rocha <christian@rocha.is>
Date: Thu, 9 Apr 2026 12:26:38 -0400
Subject: [PATCH] chore(tools/mcp): generally improve mcp tool descriptions

---
 internal/agent/tools/list_mcp_resources.md | 2 +-
 internal/agent/tools/read_mcp_resource.md  | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

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.