Design a Model Context Protocol tool that implements:

Tool Structure:
- JSON Schema definition with proper typing
- Required and optional parameters
- Clear description and examples
- Proper error handling patterns

Input Validation:
- Type checking
- Value constraints
- Fallback behavior
- Parameter dependencies

Output Structure:
- Consistent return format
- Error reporting
- Pagination for large outputs
- Status indicators

Implementation Details:
- Synchronous and asynchronous variants
- Timeout handling
- Resource usage considerations
- Security boundaries

Documentation:
- Usage examples
- Edge cases
- Performance characteristics
- Integration patterns

The user has provided the following tool requirements: