mongodb-mcp-server 0.1.0 → 0.1.1

package/.github/CODEOWNERS

@@ -1,3 +1 @@
 *          @mongodb-js/mcp-server-developers
-**/atlas   @blva @fmenezes
-**/mongodb @nirinchev @gagik

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -7,6 +7,14 @@ body:
   - type: markdown
     attributes:
       value: "Please fill out the following details to help us address the issue."
+  - type: textarea
+    id: version
+    attributes:
+      label: "Version"
+      description: "Please provide the version of the MCP Server where the bug occurred. (e.g., 0.1.0, main branch sha, etc.)"
+      placeholder: "e.g., 0.1.0"
+    validations:
+      required: true
   - type: checkboxes
     id: app
     attributes:

package/.github/workflows/{lint.yml → check.yml}

@@ -1,10 +1,13 @@
 ---
-name: Lint
+name: Checks
 on:
   push:
     branches:
       - main
   pull_request:
+  pull_request_target:
+    branches:
+      - main
 
 permissions: {}
 
@@ -35,3 +38,21 @@ jobs:
       - name: Install dependencies
         run: npm ci
       - run: npm run generate
+
+  check-dep:
+    name: Check dependencies
+    runs-on: ubuntu-latest
+    steps:
+      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: package.json
+          cache: "npm"
+      - name: Install dependencies, build and remove dev dependencies
+        run: |
+          npm ci
+          rm -rf node_modules
+          npm pkg set scripts.prepare="exit 0"
+          npm install --omit=dev
+      - run: npx -y @modelcontextprotocol/inspector --cli --method tools/list -- node dist/index.js --connectionString "mongodb://localhost"

package/.github/workflows/code_health.yaml

@@ -62,26 +62,6 @@ jobs:
           name: atlas-test-results
           path: coverage/lcov.info
 
-  dep-check:
-    name: Check dependencies
-    if: github.event.pull_request.user.login != 'dependabot[bot]' && github.event.pull_request.head.repo.full_name == github.repository
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies & build
-        run: npm ci
-      - name: Remove dev dependencies
-        run: |
-          rm -rf node_modules
-          npm pkg set scripts.prepare="exit 0"
-          npm install --omit=dev
-      - run: npx -y @modelcontextprotocol/inspector --cli --method tools/list -- node dist/index.js --connectionString "mongodb://localhost"
-
   coverage:
     name: Report Coverage
     if: always() && github.event.pull_request.user.login != 'dependabot[bot]' && github.event.pull_request.head.repo.full_name == github.repository
@@ -112,5 +92,3 @@ jobs:
         uses: coverallsapp/github-action@v2.3.6
         with:
           file: coverage/lcov.info
-          git-branch: ${{ github.head_ref || github.ref_name }}
-          git-commit: ${{ github.event.pull_request.head.sha || github.sha }}

package/.github/workflows/code_health_fork.yaml

@@ -11,9 +11,14 @@ jobs:
   run-tests:
     name: Run MongoDB tests
     if: github.event.pull_request.user.login == 'dependabot[bot]' || github.event.pull_request.head.repo.full_name != github.repository
-    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+      fail-fast: false
+    runs-on: ${{ matrix.os }}
     steps:
       - uses: GitHubSecurityLab/actions-permissions/monitor@v1
+        if: matrix.os != 'windows-latest'
       - uses: actions/checkout@v4
       - uses: actions/setup-node@v4
         with:
@@ -24,71 +29,12 @@ jobs:
       - name: Run tests
         run: npm test
       - name: Upload test results
-        if: always()
+        if: always() && matrix.os == 'ubuntu-latest'
         uses: actions/upload-artifact@v4
         with:
           name: test-results
           path: coverage/lcov.info
 
-  run-atlas-tests:
-    name: Run Atlas tests
-    if: github.event.pull_request.user.login == 'dependabot[bot]' || github.event.pull_request.head.repo.full_name != github.repository
-    runs-on: ubuntu-latest
-    steps:
-      - uses: GitHubSecurityLab/actions-permissions/monitor@v1
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Run tests
-        env:
-          MDB_MCP_API_CLIENT_ID: ${{ secrets.TEST_ATLAS_CLIENT_ID }}
-          MDB_MCP_API_CLIENT_SECRET: ${{ secrets.TEST_ATLAS_CLIENT_SECRET }}
-          MDB_MCP_API_BASE_URL: ${{ vars.TEST_ATLAS_BASE_URL }}
-        run: npm test -- --testPathIgnorePatterns "tests/integration/tools/mongodb" --testPathIgnorePatterns "tests/integration/[^/]+\.ts"
-      - name: Upload test results
-        uses: actions/upload-artifact@v4
-        if: always()
-        with:
-          name: atlas-test-results
-          path: coverage/lcov.info
-
-  coverage:
-    name: Report Coverage
-    if: always() && github.event.pull_request.user.login == 'dependabot[bot]' || github.event.pull_request.head.repo.full_name != github.repository
-    runs-on: ubuntu-latest
-    needs: [run-tests, run-atlas-tests]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version-file: package.json
-          cache: "npm"
-      - name: Install dependencies
-        run: npm ci
-      - name: Download test results
-        uses: actions/download-artifact@v4
-        with:
-          name: test-results
-          path: coverage/mongodb
-      - name: Download atlas test results
-        uses: actions/download-artifact@v4
-        with:
-          name: atlas-test-results
-          path: coverage/atlas
-      - name: Merge coverage reports
-        run: |
-          npx -y lcov-result-merger@5.0.1 "coverage/*/lcov.info" "coverage/lcov.info"
-      - name: Coveralls GitHub Action
-        uses: coverallsapp/github-action@v2.3.6
-        with:
-          file: coverage/lcov.info
-          git-branch: ${{ github.head_ref || github.ref_name }}
-          git-commit: ${{ github.event.pull_request.head.sha || github.sha }}
-
   merge-dependabot-pr:
     name: Merge Dependabot PR
     if: github.event.pull_request.user.login == 'dependabot[bot]'
@@ -96,8 +42,6 @@ jobs:
     permissions:
       pull-requests: write
       contents: write
-    needs:
-      - coverage
     steps:
       - name: Enable auto-merge for Dependabot PRs
         run: gh pr merge --auto --squash "$PR_URL"

package/.vscode/extensions.json

@@ -0,0 +1,9 @@
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=827846 to learn about workspace recommendations.
+  // Extension identifier format: ${publisher}.${name}. Example: vscode.csharp
+
+  // List of extensions which should be recommended for users of this workspace.
+  "recommendations": ["firsttris.vscode-jest-runner", "orta.vscode-jest"],
+  // List of extensions recommended by VS Code that should not be recommended for users of this workspace.
+  "unwantedRecommendations": []
+}

package/.vscode/settings.json

@@ -0,0 +1,11 @@
+{
+  "jestrunner.jestCommand": "npm test --",
+  "jestrunner.debugOptions": {
+    "runtimeExecutable": "node",
+    "runtimeArgs": [
+      "--experimental-vm-modules",
+      "node_modules/jest/bin/jest.js",
+      "--coverage"
+    ]
+  }
+}

package/README.md

@@ -29,7 +29,7 @@ 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
@@ -38,8 +38,10 @@ node -v
 
 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,7 +51,7 @@ You can pass your connection string via args, make sure to use a valid username
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
@@ -65,29 +67,44 @@ You can pass your connection string via args, make sure to use a valid username
 
 #### 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)
@@ -227,7 +244,7 @@ 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
 
@@ -241,9 +258,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 +275,7 @@ export MDB_MCP_LOG_PATH="/path/to/logs"
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": ["-y", "mongodb-mcp-server"],
@@ -274,13 +291,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 +309,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 +318,7 @@ npx -y mongodb-mcp-server --apiClientId="your-atlas-client-id" --apiClientSecret
 
 ```json
 {
-  "servers": {
+  "mcpServers": {
     "MongoDB": {
       "command": "npx",
       "args": [
@@ -319,16 +336,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,7 +1,7 @@
 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) {
@@ -26,13 +26,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 +51,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 +76,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 +133,145 @@ 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 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;
     }
 }