mongodb-mcp-server 0.1.0 → 0.1.2

package/README.md

@@ -1,3 +1,7 @@
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?logo=data:image/svg%2bxml;base64,PHN2ZyBmaWxsPSIjRkZGRkZGIiB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciICB2aWV3Qm94PSIwIDAgNDggNDgiIHdpZHRoPSIyNHB4IiBoZWlnaHQ9IjI0cHgiPjxwYXRoIGQ9Ik00NC45OTkgMTAuODd2MjYuMjFjMCAxLjAzLS41OSAxLjk3LTEuNTEgMi40Mi0yLjY4IDEuMjktOCAzLjg1LTguMzUgNC4wMS0uMTMuMDctLjM4LjItLjY3LjMxLjM1LS42LjUzLTEuMy41My0yLjAyVjYuMmMwLS43NS0uMi0xLjQ1LS41Ni0yLjA2LjA5LjA0LjE3LjA4LjI0LjExLjIuMSA1Ljk4IDIuODYgOC44IDQuMkM0NC40MDkgOC45IDQ0Ljk5OSA5Ljg0IDQ0Ljk5OSAxMC44N3pNNy40OTkgMjYuMDNjMS42IDEuNDYgMy40MyAzLjEzIDUuMzQgNC44NmwtNC42IDMuNWMtLjc3LjU3LTEuNzguNS0yLjU2LS4wNS0uNS0uMzYtMS44OS0xLjY1LTEuODktMS42NS0xLjAxLS44MS0xLjA2LTIuMzItLjExLTMuMTlDMy42NzkgMjkuNSA1LjE3OSAyOC4xMyA3LjQ5OSAyNi4wM3pNMzEuOTk5IDYuMnYxMC4xMWwtNy42MyA1LjgtNi44NS01LjIxYzQuOTgtNC41MyAxMC4wMS05LjExIDEyLjY1LTExLjUyQzMwLjg2OSA0Ljc0IDMxLjk5OSA1LjI1IDMxLjk5OSA2LjJ6TTMyIDQxLjc5OFYzMS42OUw4LjI0IDEzLjYxYy0uNzctLjU3LTEuNzgtLjUtMi41Ni4wNS0uNS4zNi0xLjg5IDEuNjUtMS44OSAxLjY1LTEuMDEuODEtMS4wNiAyLjMyLS4xMSAzLjE5IDAgMCAyMC4xNDUgMTguMzM4IDI2LjQ4NSAyNC4xMTZDMzAuODcxIDQzLjI2IDMyIDQyLjc1MyAzMiA0MS43OTh6Ii8+PC9zdmc+)](https://insiders.vscode.dev/redirect/mcp/install?name=mongodb&inputs=%5B%7B%22id%22%3A%22connection_string%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22MongoDB%20connection%20string%22%7D%5D&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mongodb-mcp-server%22%5D%2C%22env%22%3A%7B%22MDB_MCP_CONNECTION_STRING%22%3A%22%24%7Binput%3Aconnection_string%7D%22%7D%7D)
+[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_Server-1e1e1e?logo=data:image/svg%2bxml;base64,PHN2ZyBoZWlnaHQ9IjFlbSIgc3R5bGU9ImZsZXg6bm9uZTtsaW5lLWhlaWdodDoxIiB2aWV3Qm94PSIwIDAgMjQgMjQiIHdpZHRoPSIxZW0iCiAgICB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciPgogICAgPHRpdGxlPkN1cnNvcjwvdGl0bGU+CiAgICA8cGF0aCBkPSJNMTEuOTI1IDI0bDEwLjQyNS02LTEwLjQyNS02TDEuNSAxOGwxMC40MjUgNnoiCiAgICAgICAgZmlsbD0idXJsKCNsb2JlLWljb25zLWN1cnNvcnVuZGVmaW5lZC1maWxsLTApIj48L3BhdGg+CiAgICA8cGF0aCBkPSJNMjIuMzUgMThWNkwxMS45MjUgMHYxMmwxMC40MjUgNnoiIGZpbGw9InVybCgjbG9iZS1pY29ucy1jdXJzb3J1bmRlZmluZWQtZmlsbC0xKSI+PC9wYXRoPgogICAgPHBhdGggZD0iTTExLjkyNSAwTDEuNSA2djEybDEwLjQyNS02VjB6IiBmaWxsPSJ1cmwoI2xvYmUtaWNvbnMtY3Vyc29ydW5kZWZpbmVkLWZpbGwtMikiPjwvcGF0aD4KICAgIDxwYXRoIGQ9Ik0yMi4zNSA2TDExLjkyNSAyNFYxMkwyMi4zNSA2eiIgZmlsbD0iIzU1NSI+PC9wYXRoPgogICAgPHBhdGggZD0iTTIyLjM1IDZsLTEwLjQyNSA2TDEuNSA2aDIwLjg1eiIgZmlsbD0iI2ZmZiI+PC9wYXRoPgogICAgPGRlZnM+CiAgICAgICAgPGxpbmVhckdyYWRpZW50IGdyYWRpZW50VW5pdHM9InVzZXJTcGFjZU9uVXNlIiBpZD0ibG9iZS1pY29ucy1jdXJzb3J1bmRlZmluZWQtZmlsbC0wIgogICAgICAgICAgICB4MT0iMTEuOTI1IiB4Mj0iMTEuOTI1IiB5MT0iMTIiIHkyPSIyNCI+CiAgICAgICAgICAgIDxzdG9wIG9mZnNldD0iLjE2IiBzdG9wLWNvbG9yPSIjZmZmIiBzdG9wLW9wYWNpdHk9Ii4zOSI+PC9zdG9wPgogICAgICAgICAgICA8c3RvcCBvZmZzZXQ9Ii42NTgiIHN0b3AtY29sb3I9IiNmZmYiIHN0b3Atb3BhY2l0eT0iLjgiPjwvc3RvcD4KICAgICAgICA8L2xpbmVhckdyYWRpZW50PgogICAgICAgIDxsaW5lYXJHcmFkaWVudCBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgaWQ9ImxvYmUtaWNvbnMtY3Vyc29ydW5kZWZpbmVkLWZpbGwtMSIKICAgICAgICAgICAgeDE9IjIyLjM1IiB4Mj0iMTEuOTI1IiB5MT0iNi4wMzciIHkyPSIxMi4xNSI+CiAgICAgICAgICAgIDxzdG9wIG9mZnNldD0iLjE4MiIgc3RvcC1jb2xvcj0iI2ZmZiIgc3RvcC1vcGFjaXR5PSIuMzEiPjwvc3RvcD4KICAgICAgICAgICAgPHN0b3Agb2Zmc2V0PSIuNzE1IiBzdG9wLWNvbG9yPSIjZmZmIiBzdG9wLW9wYWNpdHk9IjAiPjwvc3RvcD4KICAgICAgICA8L2xpbmVhckdyYWRpZW50PgogICAgICAgIDxsaW5lYXJHcmFkaWVudCBncmFkaWVudFVuaXRzPSJ1c2VyU3BhY2VPblVzZSIgaWQ9ImxvYmUtaWNvbnMtY3Vyc29ydW5kZWZpbmVkLWZpbGwtMiIKICAgICAgICAgICAgeDE9IjExLjkyNSIgeDI9IjEuNSIgeTE9IjAiIHkyPSIxOCI+CiAgICAgICAgICAgIDxzdG9wIHN0b3AtY29sb3I9IiNmZmYiIHN0b3Atb3BhY2l0eT0iLjYiPjwvc3RvcD4KICAgICAgICAgICAgPHN0b3Agb2Zmc2V0PSIuNjY3IiBzdG9wLWNvbG9yPSIjZmZmIiBzdG9wLW9wYWNpdHk9Ii4yMiI+PC9zdG9wPgogICAgICAgIDwvbGluZWFyR3JhZGllbnQ+CiAgICA8L2RlZnM+Cjwvc3ZnPgo=)](https://cursor.com/install-mcp?name=MongoDB&config=eyJjb21tYW5kIjoibnB4IC15IG1vbmdvZGItbWNwLXNlcnZlciJ9)
+[![View on Smithery](https://smithery.ai/badge/@mongodb-js/mongodb-mcp-server)](https://smithery.ai/server/@mongodb-js/mongodb-mcp-server)
+
 # MongoDB MCP Server
 
 A Model Context Protocol server for interacting with MongoDB Databases and MongoDB Atlas.
@@ -22,24 +26,28 @@ A Model Context Protocol server for interacting with MongoDB Databases and Mongo
 
 ## Prerequisites
 
-- Node.js (v20 or later)
+- Node.js (v20.10.0 or later)
 
 ```shell
 node -v
 ```
 
 - A MongoDB connection string or Atlas API credentials, **_the Server will not start unless configured_**.
-  - **_Atlas API credentials_** are required to use the Atlas tools. You can create a service account in MongoDB Atlas and use its credentials for authentication. See [Atlas API Access](#atlas-api-access) for more details.
+  - **_Service Accounts Atlas API credentials_** are required to use the Atlas tools. You can create a service account in MongoDB Atlas and use its credentials for authentication. See [Atlas API Access](#atlas-api-access) for more details.
   - If you have a MongoDB connection string, you can use it directly to connect to your MongoDB instance.
 
 ## Setup
 
 ### Quick Start
 
+> **Note:** When using Atlas API credentials, be sure to assign only the minimum required permissions to your service account. See [Atlas API Permissions](#atlas-api-permissions) for details.
+
 Most MCP clients require a configuration file to be created or modified to add the MCP server.
 
+Note: The configuration file syntax can be different across clients. Please refer to the following links for the latest expected syntax:
+
 - **Windsurf**:https://docs.windsurf.com/windsurf/mcp
-- **VSCode**: https://docs.codeium.com/docs/mcp
+- **VSCode**: https://code.visualstudio.com/docs/copilot/chat/mcp-servers
 - **Claude Desktop**: https://modelcontextprotocol.io/quickstart/user
 - **Cursor**: https://docs.cursor.com/context/model-context-protocol
 
@@ -49,49 +57,155 @@ You can pass your connection string via args, make sure to use a valid username
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
         "-y",
         "mongodb-mcp-server",
         "--connectionString",
-        "mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
+        "mongodb://localhost:27017/myDatabase"
       ]
     }
   }
 }
 ```
 
+NOTE: The connection string can be configured to connect to any MongoDB cluster, whether it's a local instance or an Atlas cluster.
+
 #### Option 2: Atlas API credentials args
 
-Use your Atlas API Service Account credentials. More details in the [Atlas API Access](#atlas-api-access) section.
+Use your Atlas API Service Accounts credentials. Must follow all the steps in [Atlas API Access](#atlas-api-access) section.
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
         "-y",
         "mongodb-mcp-server",
         "--apiClientId",
-        "your-atlas-client-id",
+        "your-atlas-service-accounts-client-id",
         "--apiClientSecret",
-        "your-atlas-client-secret"
+        "your-atlas-service-accounts-client-secret"
       ]
     }
   }
 }
 ```
 
-#### Other options
+#### Option 3: Standalone Service using command arguments
+
+Start Server using npx command:
+
+```shell
+ npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret"
+```
+
+- For a complete list of arguments see [Configuration Options](#configuration-options)
+- To configure your Atlas Service Accounts credentials please refer to [Atlas API Access](#atlas-api-access)
+
+#### Option 4: Standalone Service using environment variables
+
+```shell
+ npx -y mongodb-mcp-server
+```
 
-Alternatively you can use environment variables in the config file or set them and run the server via npx.
+You can use environment variables in the config file or set them and run the server via npx.
 
 - Connection String via environment variables in the MCP file [example](#connection-string-with-environment-variables)
 - Atlas API credentials via environment variables in the MCP file [example](#atlas-api-credentials-with-environment-variables)
 
+#### Option 5: Using Docker
+
+You can run the MongoDB MCP Server in a Docker container, which provides isolation and doesn't require a local Node.js installation.
+
+#### Run with Environment Variables
+
+You may provide either a MongoDB connection string OR Atlas API credentials:
+
+##### Option A: No configuration
+
+```shell
+docker run --rm -i \
+  mongodb/mongodb-mcp-server:latest
+```
+
+##### Option B: With MongoDB connection string
+
+```shell
+docker run --rm -i \
+  -e MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" \
+  mongodb/mongodb-mcp-server:latest
+```
+
+##### Option C: With Atlas API credentials
+
+```shell
+docker run --rm -i \
+  -e MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id" \
+  -e MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret" \
+  mongodb/mongodb-mcp-server:latest
+```
+
+##### Docker in MCP Configuration File
+
+Without options:
+
+```json
+{
+  "mcpServers": {
+    "MongoDB": {
+      "command": "docker",
+      "args": ["run", "--rm", "-i", "mongodb/mongodb-mcp-server:latest"]
+    }
+  }
+}
+```
+
+With connection string:
+
+```json
+{
+  "mcpServers": {
+    "MongoDB": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i",
+        "-e",
+        "MDB_MCP_CONNECTION_STRING=mongodb+srv://username:password@cluster.mongodb.net/myDatabase",
+        "mongodb/mongodb-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
+With Atlas API credentials:
+
+```json
+{
+  "mcpServers": {
+    "MongoDB": {
+      "command": "docker",
+      "args": [
+        "run",
+        "--rm",
+        "-i",
+        "-e",
+        "MDB_MCP_API_CLIENT_ID=your-atlas-service-accounts-client-id",
+        "-e",
+        "MDB_MCP_API_CLIENT_SECRET=your-atlas-service-accounts-client-secret",
+        "mongodb/mongodb-mcp-server:latest"
+      ]
+    }
+  }
+}
+```
+
 ## 🛠️ Supported Tools
 
 ### Tool List
@@ -108,7 +222,8 @@ Alternatively you can use environment variables in the config file or set them a
 - `atlas-inspect-access-list` - Inspect IP/CIDR ranges with access to MongoDB Atlas clusters
 - `atlas-create-access-list` - Configure IP/CIDR access list for MongoDB Atlas clusters
 - `atlas-list-db-users` - List MongoDB Atlas database users
-- `atlas-create-db-user` - List MongoDB Atlas database users
+- `atlas-create-db-user` - Creates a MongoDB Atlas database user
+- `atlas-list-alerts` - List MongoDB Atlas Alerts for a Project
 
 NOTE: atlas tools are only available when you set credentials on [configuration](#configuration) section.
 
@@ -144,15 +259,15 @@ The MongoDB MCP Server can be configured using multiple methods, with the follow
 
 ### Configuration Options
 
-| Option             | Description                                                                                                           |
-| ------------------ | --------------------------------------------------------------------------------------------------------------------- |
-| `apiClientId`      | Atlas API client ID for authentication                                                                                |
-| `apiClientSecret`  | Atlas API client secret for authentication                                                                            |
-| `connectionString` | MongoDB connection string for direct database connections (optional users may choose to inform it on every tool call) |
-| `logPath`          | Folder to store logs                                                                                                  |
-| `disabledTools`    | An array of tool names, operation types, and/or categories of tools that will be disabled                             |
-| `readOnly`         | When set to true, only allows read and metadata operation types, disabling create/update/delete operations            |
-| `telemetry`        | When set to disabled, disables telemetry collection                                                                   |
+| Option             | Description                                                                                                                                                   |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `apiClientId`      | Atlas API client ID for authentication. Required for running Atlas tools.                                                                                     |
+| `apiClientSecret`  | Atlas API client secret for authentication. Required for running Atlas tools.                                                                                 |
+| `connectionString` | MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the `connect` tool before interacting with MongoDB data. |
+| `logPath`          | Folder to store logs.                                                                                                                                         |
+| `disabledTools`    | An array of tool names, operation types, and/or categories of tools that will be disabled.                                                                    |
+| `readOnly`         | When set to true, only allows read and metadata operation types, disabling create/update/delete operations.                                                   |
+| `telemetry`        | When set to disabled, disables telemetry collection.                                                                                                          |
 
 #### Log Path
 
@@ -211,13 +326,16 @@ You can disable telemetry using:
 
 To use the Atlas API tools, you'll need to create a service account in MongoDB Atlas:
 
+> **ℹ️ Note:** For a detailed breakdown of the minimum required permissions for each Atlas operation, see the [Atlas API Permissions](#atlas-api-permissions) section below.
+
 1. **Create a Service Account:**
 
    - Log in to MongoDB Atlas at [cloud.mongodb.com](https://cloud.mongodb.com)
    - Navigate to Access Manager > Organization Access
    - Click Add New > Applications > Service Accounts
    - Enter name, description and expiration for your service account (e.g., "MCP, MCP Server Access, 7 days")
-   - Select appropriate permissions (for full access, use Organization Owner)
+   - **Assign only the minimum permissions needed for your use case.**
+     - See [Atlas API Permissions](#atlas-api-permissions) for details.
    - Click "Create"
 
 To learn more about Service Accounts, check the [MongoDB Atlas documentation](https://www.mongodb.com/docs/atlas/api/service-accounts-overview/).
@@ -227,13 +345,33 @@ To learn more about Service Accounts, check the [MongoDB Atlas documentation](ht
    - After creation, you'll be shown the Client ID and Client Secret
    - **Important:** Copy and save the Client Secret immediately as it won't be displayed again
 
-3. **Add Access List Entry (Optional but recommended):**
+3. **Add Access List Entry:**
 
    - Add your IP address to the API access list
 
 4. **Configure the MCP Server:**
    - Use one of the configuration methods below to set your `apiClientId` and `apiClientSecret`
 
+### Atlas API Permissions
+
+> **Security Warning:** Granting the Organization Owner role is rarely necessary and can be a security risk. Assign only the minimum permissions needed for your use case.
+
+#### Quick Reference: Required roles per operation
+
+| What you want to do                  | Safest Role to Assign (where)           |
+| ------------------------------------ | --------------------------------------- |
+| List orgs/projects                   | Org Member or Org Read Only (Org)       |
+| Create new projects                  | Org Project Creator (Org)               |
+| View clusters/databases in a project | Project Read Only (Project)             |
+| Create/manage clusters in a project  | Project Cluster Manager (Project)       |
+| Manage project access lists          | Project IP Access List Admin (Project)  |
+| Manage database users                | Project Database Access Admin (Project) |
+
+- **Prefer project-level roles** for most operations. Assign only to the specific projects you need to manage or view.
+- **Avoid Organization Owner** unless you require full administrative control over all projects and settings in the organization.
+
+For a full list of roles and their privileges, see the [Atlas User Roles documentation](https://www.mongodb.com/docs/atlas/reference/user-roles/#service-user-roles).
+
 ### Configuration Methods
 
 #### Environment Variables
@@ -241,9 +379,9 @@ To learn more about Service Accounts, check the [MongoDB Atlas documentation](ht
 Set environment variables with the prefix `MDB_MCP_` followed by the option name in uppercase with underscores:
 
 ```shell
-# Set Atlas API credentials
-export MDB_MCP_API_CLIENT_ID="your-atlas-client-id"
-export MDB_MCP_API_CLIENT_SECRET="your-atlas-client-secret"
+# Set Atlas API credentials (via Service Accounts)
+export MDB_MCP_API_CLIENT_ID="your-atlas-service-accounts-client-id"
+export MDB_MCP_API_CLIENT_SECRET="your-atlas-service-accounts-client-secret"
 
 # Set a custom MongoDB connection string
 export MDB_MCP_CONNECTION_STRING="mongodb+srv://username:password@cluster.mongodb.net/myDatabase"
@@ -258,7 +396,7 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": ["-y", "mongodb-mcp-server"],
@@ -274,13 +412,13 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": ["-y", "mongodb-mcp-server"],
       "env": {
-        "MDB_MCP_API_CLIENT_ID": "your-atlas-client-id",
-        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-client-secret"
+        "MDB_MCP_API_CLIENT_ID": "your-atlas-service-accounts-client-id",
+        "MDB_MCP_API_CLIENT_SECRET": "your-atlas-service-accounts-client-secret"
       }
     }
   }
@@ -292,7 +430,7 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 Pass configuration options as command-line arguments when starting the server:
 
 ```shell
-npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret="your-atlas-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs
+npx -y mongodb-mcp-server --apiClientId="your-atlas-service-accounts-client-id" --apiClientSecret="your-atlas-service-accounts-client-secret" --connectionString="mongodb+srv://username:password@cluster.mongodb.net/myDatabase" --logPath=/path/to/logs
 ```
 
 #### MCP configuration file examples
@@ -301,7 +439,7 @@ npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
@@ -319,16 +457,16 @@ npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
         "-y",
         "mongodb-mcp-server",
         "--apiClientId",
-        "your-atlas-client-id",
+        "your-atlas-service-accounts-client-id",
         "--apiClientSecret",
-        "your-atlas-client-secret"
+        "your-atlas-service-accounts-client-secret"
       ]
     }
   }

package/dist/common/atlas/apiClient.js

@@ -1,13 +1,15 @@
 import createClient from "openapi-fetch";
 import { ClientCredentials } from "simple-oauth2";
 import { ApiClientError } from "./apiClientError.js";
-import { packageInfo } from "../../packageInfo.js";
+import { packageInfo } from "../../helpers/packageInfo.js";
 const ATLAS_API_VERSION = "2025-03-12";
 export class ApiClient {
     constructor(options) {
         this.getAccessToken = async () => {
             if (this.oauth2Client && (!this.accessToken || this.accessToken.expired())) {
-                this.accessToken = await this.oauth2Client.getToken({});
+                this.accessToken = await this.oauth2Client.getToken({
+                    agent: this.options.userAgent,
+                });
             }
             return this.accessToken?.token.access_token;
         };
@@ -26,13 +28,6 @@ export class ApiClient {
                 }
             },
         };
-        this.errorMiddleware = {
-            async onResponse({ response }) {
-                if (!response.ok) {
-                    throw await ApiClientError.fromResponse(response);
-                }
-            },
-        };
         this.options = {
             ...options,
             userAgent: options.userAgent ||
@@ -58,11 +53,13 @@ export class ApiClient {
             });
             this.client.use(this.authMiddleware);
         }
-        this.client.use(this.errorMiddleware);
     }
     hasCredentials() {
         return !!(this.oauth2Client && this.accessToken);
     }
+    async validateAccessToken() {
+        await this.getAccessToken();
+    }
     async getIpInfo() {
         const accessToken = await this.getAccessToken();
         const endpoint = "api/private/ipinfo";
@@ -81,19 +78,53 @@ export class ApiClient {
         return (await response.json());
     }
     async sendEvents(events) {
-        let endpoint = "api/private/unauth/telemetry/events";
+        if (!this.options.credentials) {
+            await this.sendUnauthEvents(events);
+            return;
+        }
+        try {
+            await this.sendAuthEvents(events);
+        }
+        catch (error) {
+            if (error instanceof ApiClientError) {
+                if (error.response.status !== 401) {
+                    throw error;
+                }
+            }
+            // send unauth events if any of the following are true:
+            // 1: the token is not valid (not ApiClientError)
+            // 2: if the api responded with 401 (ApiClientError with status 401)
+            await this.sendUnauthEvents(events);
+        }
+    }
+    async sendAuthEvents(events) {
+        const accessToken = await this.getAccessToken();
+        if (!accessToken) {
+            throw new Error("No access token available");
+        }
+        const authUrl = new URL("api/private/v1.0/telemetry/events", this.options.baseUrl);
+        const response = await fetch(authUrl, {
+            method: "POST",
+            headers: {
+                Accept: "application/json",
+                "Content-Type": "application/json",
+                "User-Agent": this.options.userAgent,
+                Authorization: `Bearer ${accessToken}`,
+            },
+            body: JSON.stringify(events),
+        });
+        if (!response.ok) {
+            throw await ApiClientError.fromResponse(response);
+        }
+    }
+    async sendUnauthEvents(events) {
         const headers = {
             Accept: "application/json",
             "Content-Type": "application/json",
             "User-Agent": this.options.userAgent,
         };
-        const accessToken = await this.getAccessToken();
-        if (accessToken) {
-            endpoint = "api/private/v1.0/telemetry/events";
-            headers["Authorization"] = `Bearer ${accessToken}`;
-        }
-        const url = new URL(endpoint, this.options.baseUrl);
-        const response = await fetch(url, {
+        const unauthUrl = new URL("api/private/unauth/telemetry/events", this.options.baseUrl);
+        const response = await fetch(unauthUrl, {
             method: "POST",
             headers,
             body: JSON.stringify(events),
@@ -104,67 +135,152 @@ export class ApiClient {
     }
     // DO NOT EDIT. This is auto-generated code.
     async listClustersForAllProjects(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/clusters", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/clusters", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async listProjects(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async createProject(options) {
-        const { data } = await this.client.POST("/api/atlas/v2/groups", options);
+        const { data, error, response } = await this.client.POST("/api/atlas/v2/groups", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async deleteProject(options) {
-        await this.client.DELETE("/api/atlas/v2/groups/{groupId}", options);
+        const { error, response } = await this.client.DELETE("/api/atlas/v2/groups/{groupId}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
     }
     async getProject(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups/{groupId}", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async listProjectIpAccessLists(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups/{groupId}/accessList", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/accessList", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async createProjectIpAccessList(options) {
-        const { data } = await this.client.POST("/api/atlas/v2/groups/{groupId}/accessList", options);
+        const { data, error, response } = await this.client.POST("/api/atlas/v2/groups/{groupId}/accessList", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async deleteProjectIpAccessList(options) {
-        await this.client.DELETE("/api/atlas/v2/groups/{groupId}/accessList/{entryValue}", options);
+        const { error, response } = await this.client.DELETE("/api/atlas/v2/groups/{groupId}/accessList/{entryValue}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+    }
+    async listAlerts(options) {
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/alerts", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+        return data;
     }
     async listClusters(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups/{groupId}/clusters", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/clusters", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async createCluster(options) {
-        const { data } = await this.client.POST("/api/atlas/v2/groups/{groupId}/clusters", options);
+        const { data, error, response } = await this.client.POST("/api/atlas/v2/groups/{groupId}/clusters", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async deleteCluster(options) {
-        await this.client.DELETE("/api/atlas/v2/groups/{groupId}/clusters/{clusterName}", options);
+        const { error, response } = await this.client.DELETE("/api/atlas/v2/groups/{groupId}/clusters/{clusterName}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
     }
     async getCluster(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups/{groupId}/clusters/{clusterName}", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/clusters/{clusterName}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async listDatabaseUsers(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/groups/{groupId}/databaseUsers", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/databaseUsers", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async createDatabaseUser(options) {
-        const { data } = await this.client.POST("/api/atlas/v2/groups/{groupId}/databaseUsers", options);
+        const { data, error, response } = await this.client.POST("/api/atlas/v2/groups/{groupId}/databaseUsers", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async deleteDatabaseUser(options) {
-        await this.client.DELETE("/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}", options);
+        const { error, response } = await this.client.DELETE("/api/atlas/v2/groups/{groupId}/databaseUsers/{databaseName}/{username}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+    }
+    async listFlexClusters(options) {
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/flexClusters", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+        return data;
+    }
+    async createFlexCluster(options) {
+        const { data, error, response } = await this.client.POST("/api/atlas/v2/groups/{groupId}/flexClusters", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+        return data;
+    }
+    async deleteFlexCluster(options) {
+        const { error, response } = await this.client.DELETE("/api/atlas/v2/groups/{groupId}/flexClusters/{name}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+    }
+    async getFlexCluster(options) {
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/groups/{groupId}/flexClusters/{name}", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
+        return data;
     }
     async listOrganizations(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/orgs", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/orgs", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
     async listOrganizationProjects(options) {
-        const { data } = await this.client.GET("/api/atlas/v2/orgs/{orgId}/groups", options);
+        const { data, error, response } = await this.client.GET("/api/atlas/v2/orgs/{orgId}/groups", options);
+        if (error) {
+            throw ApiClientError.fromError(response, error);
+        }
         return data;
     }
 }