docs: update human and LLM docs and enhance tool/list schemas with actionable next steps

server/src/handlers/env.rs

@@ -190,7 +190,7 @@ impl McpTool for EnvironmentHandler {
             }
             EnvAction::LogRequirement => {
                 let key = req.key.ok_or_else(|| {
-                    crate::error::AppError::Internal("key is required for 'log_requirement' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'key' for action 'log_requirement'. Next step: Provide environment variable 'key' string in request and retry.".to_string())
                 })?;
                 let desc = req.description.unwrap_or_default();
                 let secret = req.is_secret.unwrap_or(false);
@@ -198,7 +198,7 @@ impl McpTool for EnvironmentHandler {
             }
             EnvAction::Register => {
                 let name = req.name.ok_or_else(|| {
-                    crate::error::AppError::Internal("name is required for 'register' action".to_string())
+                    crate::error::AppError::Internal("Missing required parameter 'name' for action 'register'. Next step: Provide environment 'name' string in request and retry.".to_string())
                 })?;
                 let url = req.url.unwrap_or_default();
                 let desc = req.description.unwrap_or_default();