Update tool description (#22)

Author: mkmeral

src/strands_mcp_server/server.py

@@ -12,8 +12,27 @@
 def search_docs(query: str, k: int = 5) -> List[Dict[str, Any]]:
     """Search curated documentation and return ranked results with snippets.
 
+    This tool provides access to the complete Strands Agents documentation including:
+    
+    **User Guide Topics:**
+    - Agent concepts (agent loop, conversation management, hooks, prompts, state)
+    - Model providers (Amazon Bedrock, Anthropic, Cohere, LiteLLM, LlamaAPI, MistralAI, Ollama, OpenAI, SageMaker, Writer)
+    - Multi-agent patterns (Agent2Agent, Agents as Tools, Graph, Swarm, Workflow)
+    - Tools (Python tools, MCP tools, community tools, executors)
+    - Deployment guides (EC2, EKS, Fargate, Lambda, Bedrock AgentCore)
+    - Observability & evaluation (logs, metrics, traces, evaluation)
+    - Safety & security (guardrails, PII redaction, responsible AI)
+    
+    **API Reference:**
+    - Complete API documentation for Agent, Models, Tools, Handlers, etc.
+    
+    **Examples:**
+    - Code samples and implementation examples
+    
+    Use this to find relevant Strands Agents documentation for any development question.
+
     Args:
-        query: Search query string
+        query: Search query string (e.g., "bedrock model", "tell me about a2a", "how to use MCP tools")
         k: Maximum number of results to return (default: 5)
 
     Returns:
@@ -57,6 +76,19 @@ def search_docs(query: str, k: int = 5) -> List[Dict[str, Any]]:
 def fetch_doc(uri: str) -> Dict[str, Any]:
     """Fetch full document content by URL.
 
+    Retrieves complete Strands Agents documentation content from URLs found via search_docs
+    or provided directly. Use this to get full documentation pages including:
+    
+    - Complete user guides with code examples
+    - Detailed API reference documentation  
+    - Step-by-step tutorials and implementation guides
+    - Full deployment and configuration instructions
+    - Comprehensive multi-agent pattern examples
+    - Complete model provider setup guides
+    
+    This provides the full content when search snippets aren't sufficient for 
+    understanding or implementing Strands Agents features.
+
     Args:
         uri: Document URI (supports http/https URLs)