Gateway server exposes 6 tools with basic descriptions and schemas, but significant quality gaps limit production readiness. Tool names follow verb_noun convention (gateway_search, gateway_call), but descriptions are generic and lack actionable context. Input schemas are present but minimal, most parameters lack detailed type constraints, ranges, or validation guidance. Critical security tool (gateway_run_code) has no safeguards documented. Error handling is absent from visible code. Output schemas are not documented. Composition is reasonable (each tool has one responsibility), but parameter descriptions do not guide LLM selection or explain when to use each tool vs. alternatives.

• Split gateway_search_and_call into two tools: gateway_search (returns matching tools) and gateway_call (executes a specific tool). This follows single-responsibility principle and lets agents compose them as needed.
• Expand parameter descriptions with format, constraints, and examples. E.g., 'query: Free-text search string (1-200 chars). Matches tool names and descriptions. Returns up to 10 results.' instead of 'Search query to match against tool names and descriptions'.
• Document output schemas for all tools. E.g., gateway_list_servers returns [{serverId: string, name: string, status: 'online'|'offline', toolCount: number}]. gateway_search returns [{toolName: string, serverId: string, description: string, risk: 'READ_ONLY'|'WRITE'}].
• Add security documentation to gateway_run_code: 'Executes JavaScript in isolated-vm sandbox with 5s timeout, 128MB memory limit. No access to filesystem, network, or process APIs. Code runs in strict mode. Returns {output: string, error?: string, durationMs: number}.'
• Document error handling for each tool. E.g., 'If tool not found, returns error with list of available tools. If downstream server is offline, returns error with retry guidance. If arguments are invalid, returns error with expected schema.'

Inferred effective spec: 2025-06-18+.

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