docs: reduce bloat in web-search.md guide (#2460)

Author: github-actions[bot]

docs/src/content/docs/guides/web-search.md

@@ -5,19 +5,11 @@ sidebar:
   order: 210
 ---
 
-This guide covers how to add web search capabilities to workflows using the Tavily MCP server.
-
-## Overview
-
-Some AI engines (like Copilot) don't include built-in web search functionality. To add web search capabilities to these workflows, you can integrate third-party MCP servers that provide search functionality.
-
-This guide focuses on Tavily, an AI-optimized search provider designed for LLM applications. Other alternatives include Exa (semantic search), SerpAPI (Google search access), and Brave Search (privacy-focused), though this guide only covers Tavily setup.
+This guide shows how to add web search to workflows using the Tavily MCP server, an AI-optimized search provider designed for LLM applications. While alternatives exist (Exa, SerpAPI, Brave Search), this guide focuses on Tavily configuration.
 
 ## Tavily Search
 
-[Tavily](https://tavily.com/) provides AI-optimized search designed for LLM applications with structured results.
-
-**MCP Server:** [@tavily/mcp-server](https://github.com/tavily-ai/tavily-mcp-server)
+[Tavily](https://tavily.com/) provides AI-optimized search with structured JSON responses, news search capability, and fast response times through the [@tavily/mcp-server](https://github.com/tavily-ai/tavily-mcp-server) MCP server.
 
 ```aw
 ---
@@ -39,12 +31,6 @@ Search the web for information about: ${{ github.event.issue.title }}
 Use the tavily search tool to find recent information.
 ```
 
-**Features:**
-- AI-optimized search results
-- News search capability
-- Structured JSON responses
-- Fast response times
-
 **Setup:**
 1. Sign up at [tavily.com](https://tavily.com/)
 2. Get your API key from the dashboard
@@ -54,23 +40,19 @@ Use the tavily search tool to find recent information.
 
 ## MCP Server Configuration
 
-Tavily MCP server follows this basic pattern:
+Configure the Tavily MCP server with the `allowed` list to restrict tools, store API keys in GitHub Secrets (never commit them), and use the `-y` flag with npx for automatic installation:
 
 ```yaml
 mcp-servers:
   tavily:
-    command: npx                           # Use npx for npm packages
-    args: ["-y", "@tavily/mcp-server"]     # -y to auto-install
+    command: npx
+    args: ["-y", "@tavily/mcp-server"]
     env:
       TAVILY_API_KEY: "${{ secrets.TAVILY_API_KEY }}"
-    allowed: ["search", "search_news"]    # Specific tools to allow
+    allowed: ["search", "search_news"]
 ```
 
-**Best Practices:**
-1. Always use the `allowed` list to restrict which tools can be used
-2. Store API keys in GitHub Secrets, never commit them
-3. Use `-y` flag with npx to ensure automatic installation
-4. Test MCP configuration with `gh aw mcp inspect <workflow-name>`
+Test your configuration with `gh aw mcp inspect <workflow-name>`.
 
 ## Tool Discovery
 
@@ -86,27 +68,24 @@ gh aw mcp list-tools tavily my-workflow --verbose
 
 ## Network Permissions
 
-Some engines (like Claude) require explicit network permissions for MCP servers to access external APIs:
+Engines like Claude require explicit network permissions for MCP servers:
 
 ```yaml
 engine: claude
 network:
   allowed:
-    - defaults              # Basic infrastructure
-    - "*.tavily.com"        # Tavily API
+    - defaults
+    - "*.tavily.com"
 ```
 
-The Copilot engine doesn't require explicit network permissions as MCP servers run with network access by default.
+The Copilot engine doesn't require this configuration.
 
 ## Related Documentation
 
 - [MCP Integration](/gh-aw/guides/mcps/) - Complete MCP server guide
 - [Tools](/gh-aw/reference/tools/) - Tool configuration reference
 - [AI Engines](/gh-aw/reference/engines/) - Engine capabilities and limitations
 - [CLI Commands](/gh-aw/tools/cli/) - CLI commands including `mcp inspect`
-
-## External Resources
-
 - [Model Context Protocol Specification](https://github.com/modelcontextprotocol/specification)
 - [Tavily MCP Server](https://github.com/tavily-ai/tavily-mcp-server)
 - [Tavily Documentation](https://tavily.com/)