Merge pull request #1874 from dgageot/fix-1868

Improve tool filtering doc

Author: dgageot

docs/pages/concepts/tools.html

@@ -136,12 +136,14 @@ <h3>Remote MCP (SSE / HTTP)</h3>
 
 <h2>Tool Filtering</h2>
 
-<p>MCP servers may expose many tools. You can whitelist only the ones you need:</p>
+<p>Toolsets may expose many tools. You can use the <code>tools</code> property to whitelist only the ones you need. This works for any toolset type — not just MCP:</p>
 
 <pre><code class="language-yaml">toolsets:
   - type: mcp
     ref: docker:github-official
-    tools: ["list_issues", "create_issue"]  # only these tools</code></pre>
+    tools: ["list_issues", "create_issue"]  # only these MCP tools
+  - type: filesystem
+    tools: ["read_file", "search_files_content"]  # only these filesystem tools</code></pre>
 
 <h2>Tool Instructions</h2>
 

docs/pages/configuration/tools.html

@@ -330,12 +330,16 @@ <h3>Remote MCP (SSE / Streamable HTTP)</h3>
 
 <h2>Tool Filtering</h2>
 
-<p>MCP servers often expose many tools. Use the <code>tools</code> property to whitelist only the ones your agent needs:</p>
+<p>Toolsets may expose many tools. Use the <code>tools</code> property to whitelist only the ones your agent needs. This works for any toolset type — not just MCP:</p>
 
 <pre><code class="language-yaml">toolsets:
   - type: mcp
     ref: docker:github-official
-    tools: ["list_issues", "create_issue", "get_pull_request"]</code></pre>
+    tools: ["list_issues", "create_issue", "get_pull_request"]
+  - type: filesystem
+    tools: ["read_file", "search_files_content"]
+  - type: shell
+    tools: ["shell"]</code></pre>
 
 <div class="callout callout-tip">
   <div class="callout-title">💡 Tip</div>