ToolGate exposes only 2 tools with minimal schema documentation. listTools has a trivial description (5 words) and no input schema visible. callTool has a basic input schema but lacks output schema documentation, error handling guidance, and parameter descriptions are generic. Neither tool has descriptions meeting the 10-1024 character baseline (listTools is ~40 chars, callTool is ~80 chars but lacks depth). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite callTool being a WRITE operation. No pagination support visible for listTools despite it returning potentially large tool lists. Error handling is absent, no recovery guidance, no categorization of retryable vs fatal errors.

• Add explicit input schema to listTools with optional parameters (e.g., provider_key filter, limit, offset) and document pagination support.
• Document callTool output schema: what fields are returned on success? Include tool result structure, execution time, and any error details.
• Expand listTools description to 100-150 chars: 'Discover all available tools from connected MCP providers. Returns tool name, description, input schema, and provider key. Call this first to see what tools are available before invoking callTool.'
• Add parameter descriptions: name='Tool identifier in format provider_key/tool_name (e.g., github/create_issue)'; arguments='Object containing tool-specific parameters matching the tool's input schema.'
• Add tool annotations: mark callTool with destructiveHint=true if any tool it proxies modifies state; mark listTools with readOnlyHint=true.

Inferred effective spec: <=2025-11-25.

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