diff --git a/README.md b/README.md
index aff5345..35bee91 100644
--- a/README.md
+++ b/README.md
@@ -167,6 +167,8 @@ Specialized tool for analyzing large files or multiple files that exceed Claude'
 "Have Gemini review these files together: auth.py, users.py, permissions.py"
 ```
 
+**Note on Terminal Output:** When using direct code input, the MCP client displays the full content in the terminal. For better readability with large content, save it to a file first and provide the file path instead.
+
 ### `list_models`
 Lists available Gemini models (defaults to 2.5 Pro Preview).
 
diff --git a/gemini_server.py b/gemini_server.py
index 1934d8f..9676305 100755
--- a/gemini_server.py
+++ b/gemini_server.py
@@ -237,7 +237,7 @@ async def handle_list_tools() -> List[Tool]:
         ),
         Tool(
             name="analyze_code",
-            description="Analyze code files or snippets with Gemini's 1M context window",
+            description="Analyze code files or snippets with Gemini's 1M context window. For large content, use file paths to avoid terminal clutter.",
             inputSchema={
                 "type": "object",
                 "properties": {
@@ -248,7 +248,7 @@ async def handle_list_tools() -> List[Tool]:
                     },
                     "code": {
                         "type": "string",
-                        "description": "Direct code content to analyze (alternative to files)",
+                        "description": "Direct code content to analyze (use for small snippets only; prefer files for large content)",
                     },
                     "question": {
                         "type": "string",