chore: add more details for some api errors

Author: blva

src/tools/atlas/atlasTool.ts

@@ -1,7 +1,9 @@
-import { ToolBase, ToolCategory, TelemetryToolMetadata } from "../tool.js";
+import { ToolBase, ToolCategory, TelemetryToolMetadata, ToolArgs } from "../tool.js";
 import { ToolCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import logger, { LogId } from "../../logger.js";
 import { z } from "zod";
+import { ApiClientError } from "../../common/atlas/apiClientError.js";
 
 export abstract class AtlasToolBase extends ToolBase {
     protected category: ToolCategory = "atlas";
@@ -13,6 +15,54 @@ export abstract class AtlasToolBase extends ToolBase {
         return super.verifyAllowed();
     }
 
+    protected handleError(
+        error: unknown,
+        args: ToolArgs<typeof this.argsShape>
+    ): Promise<CallToolResult> | CallToolResult {
+        if (error instanceof ApiClientError) {
+            const statusCode = error.response.status;
+
+            if (statusCode === 401) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Unable to authenticate with MongoDB Atlas. Your API credentials may be invalid, expired or lack permissions. Please check your Atlas API credentials and ensure they have the appropriate permissions. For more information on setting up API keys, visit: https://www.mongodb.com/docs/atlas/configure-api-access/`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+
+            if (statusCode === 403) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `You don't have sufficient permissions to perform this action in MongoDB Atlas. Please ensure your API key has the necessary roles assigned. For more information on Atlas API access roles, visit: https://www.mongodb.com/docs/atlas/api/service-accounts-overview/`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+
+            if (statusCode === 429) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `MongoDB Atlas API rate limit exceeded. Please wait before making additional requests. For more information on rate limits, visit: https://www.mongodb.com/docs/atlas/api/#rate-limits`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+
+        // For other types of errors, use the default error handling from the base class
+        return super.handleError(error, args);
+    }
+
     /**
      *
      * Resolves the tool metadata from the arguments passed to the tool