Two tools with minimal parameter descriptions and no documented output schemas. check_connection has empty input schema ({}), violating schema requirements. get_project_operating_margins has a single array parameter with basic description but no output schema documentation. Both tools lack error handling guidance, recovery hints, and actionable error messages. Descriptions are present but generic (Portuguese text, no LLM-optimized phrasing). No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite both being read-only operations. Tool names follow verb_noun pattern (check_, get_) which is correct, but descriptions do not explain WHEN to use each tool or what downstream operations they enable.

• Add output schema documentation to both tools. For check_connection, document: {serverName: string, databaseName: string, loginName: string, serverTime: ISO8601, canSelectDatabase: boolean}. For get_project_operating_margins, document the array of {costCenter, project, status, income, cost, operatingMargin, operatingMarginPercentage}.
• Rewrite descriptions in English, LLM-optimized format (50-200 chars). Example: 'check_connection: Verify read-only access to Softland SQL Server replica. Returns server name, database, login, current time, and SELECT permission status. Call this first to validate credentials.' Example: 'get_project_operating_margins: Query revenue, costs, and operating margin by cost center and project for specified fiscal years (1-10 years). Returns aggregated financial metrics. Requires valid years array.'
• Add parameter descriptions to get_project_operating_margins.years: 'Array of fiscal years to query (1-10 years, e.g. [2023, 2024]). Each year must be a positive integer. Required.'
• Implement error handling with actionable messages. Catch connection errors and return: 'Database connection failed: [specific reason]. Verify environment variables: SQL_SERVER, SQL_PORT, SQL_DATABASE, SQL_USER, SQL_PASSWORD.' Catch invalid years and return: 'Invalid years: [values]. Must be 1-10 positive integers, e.g. [2023, 2024].'
• Add readOnlyHint: true to both tool definitions in registerCheckConnectionTool and registerGetProjectOperatingMarginsTool to signal safety to agents.