fix: update MCP CLI commands in documentation (#1976)

* fix: update MCP CLI commands in documentation

Replace list-tools with tools command in README and examples
Update cli_tools_example.sh with correct CLI commands
Update test file comments to reflect actual CLI commands
Remove references to non-existent pagination flags and search subcommands

Fixes #1970

Co-authored-by: praisonai-triage-agent[bot] <praisonai-triage-agent[bot]@users.noreply.github.com>

* fix: correct MCP CLI commands in documentation to match actual implementation

- Replace non-existent commands (describe, sync, list) with actual working commands (list-tools, tools search/info/schema)
- Fix README.md to document commands that exist in MCPServerCLI.handle()
- Fix cli_tools_example.sh to use working CLI commands
- Fix test docstrings to accurately describe what is being tested

Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>

---------

Co-authored-by: praisonai-triage-agent[bot] <272766704+praisonai-triage-agent[bot]@users.noreply.github.com>
Co-authored-by: praisonai-triage-agent[bot] <praisonai-triage-agent[bot]@users.noreply.github.com>
Co-authored-by: Mervin Praison <MervinPraison@users.noreply.github.com>

Author: MervinPraison

src/praisonai/examples/mcp/README.md

@@ -32,25 +32,25 @@ python tool_annotations_example.py
 
 ### 3. CLI Tools (`cli_tools_example.sh`)
 
-Demonstrates the new CLI commands:
+Demonstrates the CLI commands:
 
 ```bash
-# List tools with pagination
-praisonai mcp list-tools --limit 10
-praisonai mcp list-tools --cursor <cursor> --json
+# List all available MCP tools
+praisonai mcp list-tools
+praisonai mcp list-tools --json
 
-# Search tools
-praisonai mcp tools search "query"
-praisonai mcp tools search --category memory
-praisonai mcp tools search --read-only
-praisonai mcp tools search --json
+# Search for specific tools
+praisonai mcp tools search "memory"
+praisonai mcp tools search --category file
 
-# Get tool info
+# Get detailed tool information
 praisonai mcp tools info <tool-name>
-praisonai mcp tools info <tool-name> --json
 
-# Get tool schema
+# Get tool JSON schema
 praisonai mcp tools schema <tool-name>
+
+# List all tools (alias)
+praisonai mcp tools list
 ```
 
 ## API Reference

src/praisonai/examples/mcp/cli_tools_example.sh

@@ -1,11 +1,11 @@
 #!/bin/bash
 # MCP CLI Tools Examples
 #
-# Demonstrates the new CLI commands for MCP tool management:
-# - praisonai mcp tools search
-# - praisonai mcp tools info
-# - praisonai mcp tools schema
-# - praisonai mcp list-tools (with pagination)
+# Demonstrates the CLI commands for MCP tool management:
+# - praisonai mcp list-tools (list all tools)
+# - praisonai mcp tools search (search tools)
+# - praisonai mcp tools info (show tool details)
+# - praisonai mcp tools schema (show tool schema)
 #
 # Usage:
 #   chmod +x cli_tools_example.sh
@@ -17,34 +17,34 @@ echo "MCP Protocol Version: 2025-11-25"
 echo "========================================"
 
 echo ""
-echo "--- List Tools (with pagination) ---"
-echo "Command: praisonai mcp list-tools --limit 5"
-praisonai mcp list-tools --limit 5
+echo "--- List All Tools ---"
+echo "Command: praisonai mcp list-tools"
+praisonai mcp list-tools
 
 echo ""
 echo "--- List Tools (JSON output) ---"
-echo "Command: praisonai mcp list-tools --json --limit 3"
-praisonai mcp list-tools --json --limit 3
+echo "Command: praisonai mcp list-tools --json"
+praisonai mcp list-tools --json
 
 echo ""
-echo "--- Tools Help ---"
-echo "Command: praisonai mcp tools --help"
-praisonai mcp tools --help
+echo "--- Search Tools ---"
+echo "Command: praisonai mcp tools search 'memory'"
+praisonai mcp tools search "memory"
 
 echo ""
-echo "--- Search Tools ---"
-echo "Command: praisonai mcp tools search 'workflow'"
-praisonai mcp tools search "workflow"
+echo "--- List Tools via tools command ---"
+echo "Command: praisonai mcp tools list"
+praisonai mcp tools list
 
 echo ""
-echo "--- Search Read-Only Tools ---"
-echo "Command: praisonai mcp tools search --read-only"
-praisonai mcp tools search --read-only
+echo "--- Tools Help ---"
+echo "Command: praisonai mcp tools help"
+praisonai mcp tools help
 
 echo ""
-echo "--- Search with JSON Output ---"
-echo "Command: praisonai mcp tools search 'memory' --json"
-praisonai mcp tools search "memory" --json
+echo "--- MCP Help ---"
+echo "Command: praisonai mcp --help"
+praisonai mcp --help
 
 echo ""
 echo "========================================"

src/praisonai/tests/unit/mcp/test_mcp_cli.py

@@ -1,11 +1,11 @@
 """
 Unit tests for MCP CLI commands.
 
-Tests the new CLI commands:
-- praisonai mcp tools search
-- praisonai mcp tools info
-- praisonai mcp tools schema
-- praisonai mcp list-tools (with pagination)
+Tests the CLI commands:
+- praisonai mcp list-tools (list tools)
+- praisonai mcp tools search (search tools)
+- praisonai mcp tools info (show tool details)
+- praisonai mcp tools schema (show tool schema)
 """
 
 import json
@@ -203,12 +203,12 @@ def test_schema_tool_not_found(self, mock_get_registry, mock_register, capsys):
 
 
 class TestListToolsCLI:
-    """Test list-tools CLI command with pagination."""
+    """Test mcp list-tools CLI command."""
 
     @patch("praisonai.mcp_server.adapters.register_all_tools")
     @patch("praisonai.mcp_server.registry.get_tool_registry")
     def test_list_tools_json(self, mock_get_registry, mock_register, capsys):
-        """Test list-tools with JSON output."""
+        """Test mcp list-tools with JSON output."""
         mock_registry = MagicMock()
         mock_registry.list_paginated.return_value = (
             [{"name": "tool1"}, {"name": "tool2"}],
@@ -228,7 +228,7 @@ def test_list_tools_json(self, mock_get_registry, mock_register, capsys):
     @patch("praisonai.mcp_server.adapters.register_all_tools")
     @patch("praisonai.mcp_server.registry.get_tool_registry")
     def test_list_tools_with_cursor(self, mock_get_registry, mock_register):
-        """Test list-tools with pagination cursor."""
+        """Test mcp list-tools with pagination cursor."""
         mock_registry = MagicMock()
         mock_registry.list_paginated.return_value = ([], None)
         mock_registry.list_all.return_value = []