OnIt exposes a single tool (view_image_from_url) with minimal definition quality. The tool name is verb-first and reasonably clear, but the input schema is severely underdocumented, the 'url' parameter has a description but lacks examples, constraints, or guidance on acceptable formats. The tool description (23 characters) is below the 34-character minimum observed in production baselines and provides no context about return format, error handling, or when to invoke it. No output schema is documented, forcing LLMs to guess what fields will be returned. The tool lacks any parameter validation hints (e.g., must be HTTP/HTTPS, timeout behavior), error recovery guidance, or security notes about the external URL handling. While the tool itself is simple and the risk classification (READ_ONLY) is correct, the overall definition lacks the rigor expected for production use.

• Expand tool description to 100 - 200 characters. Example: 'Analyzes an image from a given URL and returns a textual description of its contents, including detected objects, text, and scene context. Supports HTTP/HTTPS URLs pointing to JPEG, PNG, WebP, or GIF images. Times out after 30 seconds. Use this when you need to understand visual content from a web link.'
• Add explicit constraints to the 'url' parameter description: 'A public HTTP or HTTPS URL pointing to an image (JPEG, PNG, WebP, GIF). Maximum 50 MB. Must be reachable within 30 seconds or the request will timeout.'
• Document the return type explicitly. Add a schema section to the tool definition showing: { type: 'object', properties: { description: { type: 'string', description: 'Detailed text analysis of the image' }, detected_objects: { type: 'array', items: { type: 'string' }, description: 'List of identified objects' }, confidence: { type: 'number', description: 'Confidence score 0.0 - 1.0' } } }.
• Add error recovery guidance to the description: 'If the URL is unreachable or times out, verify the link is publicly accessible and try again. If the image format is unsupported, convert it to JPEG or PNG first.'
• Include a note on timeout and retry behavior: 'Requests timeout after 30 seconds. Retryable errors are transient network failures; non-retryable errors include invalid image format or URL syntax.'
• Add security context: 'This tool fetches from external URLs. Ensure the URL is from a trusted source to avoid malicious image injection attacks.'

Inferred effective spec: 2025-06-18+.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry