# List first page of tools (default 50)
praisonai mcp list-tools

# Output:
# Available MCP Tools (50 of 75):
#   • praisonai.workflow.run
#     Execute a PraisonAI workflow
#   ...
# More results available. Use --cursor NTA

# Get first page with limit
praisonai mcp list-tools --limit 10

# Use cursor from previous response to get next page
praisonai mcp list-tools --cursor NTA --limit 10

# Get JSON output for programmatic use
praisonai mcp list-tools --json --limit 5

{
  "tools": [
    {
      "name": "praisonai.workflow.run",
      "description": "Execute a PraisonAI workflow",
      "inputSchema": {"type": "object"},
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": true
      }
    }
  ],
  "nextCursor": "NQ"
}

#!/bin/bash
# Script to iterate through all tool pages

cursor=""
page=1

while true; do
    echo "=== Page $page ==="
    
    if [ -z "$cursor" ]; then
        result=$(praisonai mcp list-tools --json --limit 10)
    else
        result=$(praisonai mcp list-tools --json --limit 10 --cursor "$cursor")
    fi
    
    echo "$result" | jq '.tools[].name'
    
    cursor=$(echo "$result" | jq -r '.nextCursor // empty')
    
    if [ -z "$cursor" ]; then
        echo "No more pages"
        break
    fi
    
    page=$((page + 1))
done

# List resources
praisonai mcp list-resources

# With pagination
praisonai mcp list-resources --limit 20

# JSON output
praisonai mcp list-resources --json

# List prompts
praisonai mcp list-prompts

# With pagination
praisonai mcp list-prompts --limit 20

# JSON output
praisonai mcp list-prompts --json

praisonai mcp list-tools --cursor "invalid!!!"
# Error: Invalid cursor: ...
# Exit code: 1

praisonai mcp list-tools --cursor "MTAwMA"  # Offset 1000 when only 50 tools
# Error: Invalid cursor: offset 1000 out of range
# Exit code: 1

# Get total tool count
praisonai mcp list-tools --json --limit 1 | jq '.tools | length'

# Export all tools to JSON file
praisonai mcp list-tools --json > tools.json

# List only read-only tools (using jq)
praisonai mcp list-tools --json | \
  jq '.tools[] | select(.annotations.readOnlyHint == true) | .name'

# For more advanced filtering, use tools search
praisonai mcp tools search --read-only --json