@himanshusinghs/mongodb-mcp-server 1.0.0-prerelease.4 → 1.5.1-prerelease.2

package/README.md

@@ -1,6 +1,5 @@
 [![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%2C%22--readOnly%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=eyJjb21tYW5kIjoibnB4IC15IG1vbmdvZGItbWNwLXNlcnZlciAtLXJlYWRPbmx5In0%3D)
-[![View on Smithery](https://smithery.ai/badge/@mongodb-js/mongodb-mcp-server)](https://smithery.ai/server/@mongodb-js/mongodb-mcp-server)
+[![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/en-US/install-mcp?name=MongoDB&config=eyJjb21tYW5kIjoibnB4IC15IG1vbmdvZGItbWNwLXNlcnZlciAtLXJlYWRPbmx5In0%3D)
 
 # MongoDB MCP Server
 
@@ -24,6 +23,8 @@ A Model Context Protocol server for interacting with MongoDB Databases and Mongo
     - [Command-Line Arguments](#command-line-arguments)
     - [MCP Client Configuration](#mcp-configuration-file-examples)
     - [Proxy Support](#proxy-support)
+- [🚀 Deploy on Public Clouds](#deploy-on-public-clouds)
+  - [Azure Cloud](#azure)
 - [🤝 Contributing](#contributing)
 
 <a name="getting-started"></a>
@@ -282,44 +283,54 @@ npx -y mongodb-mcp-server@latest --transport http --httpHost=0.0.0.0 --httpPort=
 
 #### MongoDB Atlas Tools
 
-- `atlas-list-orgs` - Lists MongoDB Atlas organizations
-- `atlas-list-projects` - Lists MongoDB Atlas projects
-- `atlas-create-project` - Creates a new MongoDB Atlas project
-- `atlas-list-clusters` - Lists MongoDB Atlas clusters
-- `atlas-inspect-cluster` - Inspect a specific MongoDB Atlas cluster
+- `atlas-connect-cluster` - Connect to MongoDB Atlas cluster
+- `atlas-create-access-list` - Allow Ip/CIDR ranges to access your MongoDB Atlas clusters.
+- `atlas-create-db-user` - Create an MongoDB Atlas database user
 - `atlas-create-free-cluster` - Create a free MongoDB Atlas cluster
-- `atlas-connect-cluster` - Connects to MongoDB Atlas cluster
-- `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-create-project` - Create a MongoDB Atlas project
+- `atlas-get-performance-advisor` - Get MongoDB Atlas performance advisor recommendations and suggestions, which includes the operations: suggested indexes, drop index suggestions, schema suggestions, and a sample of the most recent (max 50) slow query logs
+- `atlas-inspect-access-list` - Inspect Ip/CIDR ranges with access to your MongoDB Atlas clusters.
+- `atlas-inspect-cluster` - Inspect metadata of a MongoDB Atlas cluster
+- `atlas-list-alerts` - List MongoDB Atlas alerts
+- `atlas-list-clusters` - List MongoDB Atlas clusters
 - `atlas-list-db-users` - 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
+- `atlas-list-orgs` - List MongoDB Atlas organizations
+- `atlas-list-projects` - List MongoDB Atlas projects
 
 NOTE: atlas tools are only available when you set credentials on [configuration](#configuration) section.
 
+#### MongoDB Atlas Local Tools
+
+- `atlas-local-connect-deployment` - Connect to a MongoDB Atlas Local deployment
+- `atlas-local-create-deployment` - Create a MongoDB Atlas local deployment
+- `atlas-local-delete-deployment` - Delete a MongoDB Atlas local deployment
+- `atlas-local-list-deployments` - List MongoDB Atlas local deployments
+
 #### MongoDB Database Tools
 
-- `connect` - Connect to a MongoDB instance
-- `find` - Run a find query against a MongoDB collection
 - `aggregate` - Run an aggregation against a MongoDB collection
-- `count` - Get the number of documents in a MongoDB collection
-- `insert-one` - Insert a single document into a MongoDB collection
-- `insert-many` - Insert multiple documents into a MongoDB collection
-- `create-index` - Create an index for a MongoDB collection
-- `update-one` - Update a single document in a MongoDB collection
-- `update-many` - Update multiple documents in a MongoDB collection
-- `rename-collection` - Rename a MongoDB collection
-- `delete-one` - Delete a single document from a MongoDB collection
-- `delete-many` - Delete multiple documents from a MongoDB collection
-- `drop-collection` - Remove a collection from a MongoDB database
-- `drop-database` - Remove a MongoDB database
-- `list-databases` - List all databases for a MongoDB connection
-- `list-collections` - List all collections for a given database
 - `collection-indexes` - Describe the indexes for a collection
 - `collection-schema` - Describe the schema for a collection
-- `collection-storage-size` - Get the size of a collection in MB
-- `db-stats` - Return statistics about a MongoDB database
-- `export` - Export query or aggregation results to EJSON format. Creates a uniquely named export accessible via the `exported-data` resource.
+- `collection-storage-size` - Gets the size of the collection
+- `connect` - Connect to a MongoDB instance
+- `count` - Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter
+- `create-collection` - Creates a new collection in a database. If the database doesn't exist, it will be created automatically.
+- `create-index` - Create an index for a collection
+- `db-stats` - Returns statistics that reflect the use state of a single database
+- `delete-many` - Removes all documents that match the filter from a MongoDB collection
+- `drop-collection` - Removes a collection or view from the database. The method also removes any indexes associated with the dropped collection.
+- `drop-database` - Removes the specified database, deleting the associated data files
+- `drop-index` - Drop an index for the provided database and collection.
+- `explain` - Returns statistics describing the execution of the winning plan chosen by the query optimizer for the evaluated method
+- `export` - Export a query or aggregation results in the specified EJSON format.
+- `find` - Run a find query against a MongoDB collection
+- `insert-many` - Insert an array of documents into a MongoDB collection. If the list of documents is above com.mongodb/maxRequestPayloadBytes, consider inserting them in batches.
+- `list-collections` - List all collections for a given database
+- `list-databases` - List all databases for a MongoDB connection
+- `mongodb-logs` - Returns the most recent logged mongod events
+- `rename-collection` - Renames a collection in a MongoDB database
+- `switch-connection` - Switch to a different MongoDB connection
+- `update-many` - Updates all documents that match the specified filter for a collection. If the list of documents is above com.mongodb/maxRequestPayloadBytes, consider updating them in batches.
 
 ## 📄 Supported Resources
 
@@ -335,30 +346,42 @@ The MongoDB MCP Server can be configured using multiple methods, with the follow
 
 1. Command-line arguments
 2. Environment variables
+3. Configuration File
 
 ### Configuration Options
 
-| CLI Option                             | Environment Variable                                | Default                                                                     | Description                                                                                                                                                                                       |
-| -------------------------------------- | --------------------------------------------------- | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `apiClientId`                          | `MDB_MCP_API_CLIENT_ID`                             | <not set>                                                                   | Atlas API client ID for authentication. Required for running Atlas tools.                                                                                                                         |
-| `apiClientSecret`                      | `MDB_MCP_API_CLIENT_SECRET`                         | <not set>                                                                   | Atlas API client secret for authentication. Required for running Atlas tools.                                                                                                                     |
-| `connectionString`                     | `MDB_MCP_CONNECTION_STRING`                         | <not set>                                                                   | MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the `connect` tool before interacting with MongoDB data.                                     |
-| `loggers`                              | `MDB_MCP_LOGGERS`                                   | disk,mcp                                                                    | Comma separated values, possible values are `mcp`, `disk` and `stderr`. See [Logger Options](#logger-options) for details.                                                                        |
-| `logPath`                              | `MDB_MCP_LOG_PATH`                                  | see note\*                                                                  | Folder to store logs.                                                                                                                                                                             |
-| `disabledTools`                        | `MDB_MCP_DISABLED_TOOLS`                            | <not set>                                                                   | An array of tool names, operation types, and/or categories of tools that will be disabled.                                                                                                        |
-| `confirmationRequiredTools`            | `MDB_MCP_CONFIRMATION_REQUIRED_TOOLS`               | create-access-list,create-db-user,drop-database,drop-collection,delete-many | An array of tool names that require user confirmation before execution. **Requires the client to support [elicitation](https://modelcontextprotocol.io/specification/draft/client/elicitation)**. |
-| `readOnly`                             | `MDB_MCP_READ_ONLY`                                 | false                                                                       | When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.                                                                             |
-| `indexCheck`                           | `MDB_MCP_INDEX_CHECK`                               | false                                                                       | When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.                                                                             |
-| `telemetry`                            | `MDB_MCP_TELEMETRY`                                 | enabled                                                                     | When set to disabled, disables telemetry collection.                                                                                                                                              |
-| `transport`                            | `MDB_MCP_TRANSPORT`                                 | stdio                                                                       | Either 'stdio' or 'http'.                                                                                                                                                                         |
-| `httpPort`                             | `MDB_MCP_HTTP_PORT`                                 | 3000                                                                        | Port number.                                                                                                                                                                                      |
-| `httpHost`                             | `MDB_MCP_HTTP_HOST`                                 | 127.0.0.1                                                                   | Host to bind the http server.                                                                                                                                                                     |
-| `idleTimeoutMs`                        | `MDB_MCP_IDLE_TIMEOUT_MS`                           | 600000                                                                      | Idle timeout for a client to disconnect (only applies to http transport).                                                                                                                         |
-| `notificationTimeoutMs`                | `MDB_MCP_NOTIFICATION_TIMEOUT_MS`                   | 540000                                                                      | Notification timeout for a client to be aware of diconnect (only applies to http transport).                                                                                                      |
-| `exportsPath`                          | `MDB_MCP_EXPORTS_PATH`                              | see note\*                                                                  | Folder to store exported data files.                                                                                                                                                              |
-| `exportTimeoutMs`                      | `MDB_MCP_EXPORT_TIMEOUT_MS`                         | 300000                                                                      | Time in milliseconds after which an export is considered expired and eligible for cleanup.                                                                                                        |
-| `exportCleanupIntervalMs`              | `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS`                | 120000                                                                      | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                              |
-| `atlasTemporaryDatabaseUserLifetimeMs` | `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` | 14400000                                                                    | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                       |
+| Environment Variable / CLI Option                                                              | Default                                                                                                | Description                                                                                                                                                                                     |
+| ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `MDB_MCP_ALLOW_REQUEST_OVERRIDES` / `--allowRequestOverrides`                                  | `false`                                                                                                | When set to true, allows configuration values to be overridden via request headers and query parameters.                                                                                        |
+| `MDB_MCP_API_CLIENT_ID` / `--apiClientId`                                                      | `<not set>`                                                                                            | Atlas API client ID for authentication. Required for running Atlas tools.                                                                                                                       |
+| `MDB_MCP_API_CLIENT_SECRET` / `--apiClientSecret`                                              | `<not set>`                                                                                            | Atlas API client secret for authentication. Required for running Atlas tools.                                                                                                                   |
+| `MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS` / `--atlasTemporaryDatabaseUserLifetimeMs` | `14400000`                                                                                             | Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.                                     |
+| `MDB_MCP_CONFIRMATION_REQUIRED_TOOLS` / `--confirmationRequiredTools`                          | `"atlas-create-access-list,atlas-create-db-user,drop-database,drop-collection,delete-many,drop-index"` | Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.                                                               |
+| `MDB_MCP_CONNECTION_STRING` / `--connectionString`                                             | `<not set>`                                                                                            | MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.                                     |
+| `MDB_MCP_DISABLED_TOOLS` / `--disabledTools`                                                   | `""`                                                                                                   | Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.                                                                                        |
+| `MDB_MCP_DRY_RUN` / `--dryRun`                                                                 | `false`                                                                                                | When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.                                                                          |
+| `MDB_MCP_EMBEDDINGS_VALIDATION` / `--embeddingsValidation`                                     | `true`                                                                                                 | When set to false, disables validation of embeddings dimensions.                                                                                                                                |
+| `MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS` / `--exportCleanupIntervalMs`                             | `120000`                                                                                               | Time in milliseconds between export cleanup cycles that remove expired export files.                                                                                                            |
+| `MDB_MCP_EXPORT_TIMEOUT_MS` / `--exportTimeoutMs`                                              | `300000`                                                                                               | Time in milliseconds after which an export is considered expired and eligible for cleanup.                                                                                                      |
+| `MDB_MCP_EXPORTS_PATH` / `--exportsPath`                                                       | see below\*                                                                                            | Folder to store exported data files.                                                                                                                                                            |
+| `MDB_MCP_HTTP_BODY_LIMIT` / `--httpBodyLimit`                                                  | `102400`                                                                                               | Maximum size of the HTTP request body in bytes (only used when transport is 'http').                                                                                                            |
+| `MDB_MCP_HTTP_HEADERS` / `--httpHeaders`                                                       | `"{}"`                                                                                                 | Header that the HTTP server will validate when making requests (only used when transport is 'http').                                                                                            |
+| `MDB_MCP_HTTP_HOST` / `--httpHost`                                                             | `"127.0.0.1"`                                                                                          | Host address to bind the HTTP server to (only used when transport is 'http').                                                                                                                   |
+| `MDB_MCP_HTTP_PORT` / `--httpPort`                                                             | `3000`                                                                                                 | Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.                                                                                                  |
+| `MDB_MCP_IDLE_TIMEOUT_MS` / `--idleTimeoutMs`                                                  | `600000`                                                                                               | Idle timeout for a client to disconnect (only applies to http transport).                                                                                                                       |
+| `MDB_MCP_INDEX_CHECK` / `--indexCheck`                                                         | `false`                                                                                                | When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.                                                                           |
+| `MDB_MCP_LOG_PATH` / `--logPath`                                                               | see below\*                                                                                            | Folder to store logs.                                                                                                                                                                           |
+| `MDB_MCP_LOGGERS` / `--loggers`                                                                | `"disk,mcp"` see below\*                                                                               | Comma separated values of logger types.                                                                                                                                                         |
+| `MDB_MCP_MAX_BYTES_PER_QUERY` / `--maxBytesPerQuery`                                           | `16777216`                                                                                             | The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.                                    |
+| `MDB_MCP_MAX_DOCUMENTS_PER_QUERY` / `--maxDocumentsPerQuery`                                   | `100`                                                                                                  | The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter. |
+| `MDB_MCP_NOTIFICATION_TIMEOUT_MS` / `--notificationTimeoutMs`                                  | `540000`                                                                                               | Notification timeout for a client to be aware of disconnect (only applies to http transport).                                                                                                   |
+| `MDB_MCP_PREVIEW_FEATURES` / `--previewFeatures`                                               | `""`                                                                                                   | Comma separated values of preview features that are enabled.                                                                                                                                    |
+| `MDB_MCP_READ_ONLY` / `--readOnly`                                                             | `false`                                                                                                | When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.                                                                           |
+| `MDB_MCP_TELEMETRY` / `--telemetry`                                                            | `"enabled"`                                                                                            | When set to disabled, disables telemetry collection.                                                                                                                                            |
+| `MDB_MCP_TRANSPORT` / `--transport`                                                            | `"stdio"`                                                                                              | Either 'stdio' or 'http'.                                                                                                                                                                       |
+| `MDB_MCP_VECTOR_SEARCH_DIMENSIONS` / `--vectorSearchDimensions`                                | `1024`                                                                                                 | Default number of dimensions for vector search embeddings.                                                                                                                                      |
+| `MDB_MCP_VECTOR_SEARCH_SIMILARITY_FUNCTION` / `--vectorSearchSimilarityFunction`               | `"euclidean"`                                                                                          | Default similarity function for vector search: 'euclidean', 'cosine', or 'dotProduct'.                                                                                                          |
+| `MDB_MCP_VOYAGE_API_KEY` / `--voyageApiKey`                                                    | `""`                                                                                                   | API key for Voyage AI embeddings service (required for vector search operations with text-to-embedding conversion).                                                                             |
 
 #### Logger Options
 
@@ -395,6 +418,8 @@ When using the `disk` logger, log files are stored in:
 
 You can override the log directory with the `logPath` option.
 
+> **🔒 Security Guideline:** The user account running the MCP server must have both read and write permissions to the `logPath` directory. Ensure this directory is properly secured with appropriate file system permissions to prevent unauthorized access to log files.
+
 #### Disabled Tools
 
 You can disable specific tools or categories of tools by using the `disabledTools` option. This option accepts an array of strings,
@@ -416,7 +441,7 @@ Operation types:
 - `update` - Tools that update resources, such as update document, rename collection, etc.
 - `delete` - Tools that delete resources, such as delete document, drop collection, etc.
 - `read` - Tools that read resources, such as find, aggregate, list clusters, etc.
-- `metadata` - Tools that read metadata, such as list databases, list collections, collection schema, etc.
+- `metadata` - Tools that read metadata, such as list databases/collections/indexes, infer collection schema, etc.
 - `connect` - Tools that allow you to connect or switch the connection to a MongoDB instance. If this is disabled, you will need to provide a connection string through the config when starting the server.
 
 #### Require Confirmation
@@ -468,6 +493,8 @@ The `exportTimeoutMs` configuration controls the time after which the exported d
 
 The `exportCleanupIntervalMs` configuration controls how frequently the cleanup process runs to remove expired export files. By default, cleanup runs every 2 minutes (120000ms).
 
+> **🔒 Security Guideline:** The user account running the MCP server must have both read and write permissions to the `exportsPath` directory. Ensure this directory is properly secured with appropriate file system permissions to prevent unauthorized access to exported data files, which may contain sensitive MongoDB data. Consider the sensitivity of your data when choosing the export location and apply restrictive permissions accordingly.
+
 #### Telemetry
 
 The `telemetry` configuration option allows you to disable telemetry collection. When enabled, the MCP server will collect usage data and send it to MongoDB.
@@ -480,6 +507,19 @@ You can disable telemetry using:
 
 > **💡 Platform Note:** For Windows users, see [Environment Variables](#environment-variables) for platform-specific instructions.
 
+#### Opting into Preview Features
+
+The MongoDB MCP Server may offer functionality that is still in development and may change in future releases. These features are considered "preview features" and are not enabled by default. Generally, these features are well tested, but may not offer the complete functionality we intend to provide in the final release or we'd like to gather feedback before making them generally available. To enable one or more preview features, use the `previewFeatures` configuration option.
+
+- For **environment variable** configuration, use a comma-separated string: `export MDB_MCP_PREVIEW_FEATURES="search,feature1,feature2"`.
+- For **command-line argument** configuration, use a space-separated string: `--previewFeatures search feature1 feature2`.
+
+List of available preview features:
+
+- `search` - Enables tools or functionality related to Atlas Search and Vector Search in MongoDB Atlas:
+  - Index management, such as creating, listing, and dropping search and vector search indexes.
+  - Querying collections using vector search capabilities. This requires a configured embedding model that will be used to generate vector representations of the query data. Currently, only [Voyage AI](https://www.voyageai.com) embedding models are supported. Set the `voyageApiKey` configuration option with your Voyage AI API key to use this feature.
+
 ### Atlas API Access
 
 To use the Atlas API tools, you'll need to create a service account in MongoDB Atlas:
@@ -529,6 +569,57 @@ For a full list of roles and their privileges, see the [Atlas User Roles documen
 
 ### Configuration Methods
 
+#### Configuration File
+
+Store configuration in a JSON file and load it using the `MDB_MCP_CONFIG` environment variable.
+
+> **🔒 Security Best Practice:** Prefer using the `MDB_MCP_CONFIG` environment variable for sensitive fields over the configuration file or `--config` CLI argument. Command-line arguments are visible in process listings.
+
+> **🔒 File Security:** Ensure your configuration file has proper ownership and permissions, limited to the user running the MongoDB MCP server:
+>
+> **Linux/macOS:**
+>
+> ```bash
+> chmod 600 /path/to/config.json
+> chown your-username /path/to/config.json
+> ```
+>
+> **Windows:** Right-click the file → Properties → Security → Restrict access to your user account only.
+
+Create a JSON file with your configuration (all keys use camelCase):
+
+```json
+{
+  "connectionString": "mongodb://localhost:27017",
+  "readOnly": true,
+  "loggers": ["stderr", "mcp"],
+  "apiClientId": "your-atlas-service-accounts-client-id",
+  "apiClientSecret": "your-atlas-service-accounts-client-secret",
+  "maxDocumentsPerQuery": 100
+}
+```
+
+**Linux/macOS (bash/zsh):**
+
+```bash
+export MDB_MCP_CONFIG="/path/to/config.json"
+npx -y mongodb-mcp-server@latest
+```
+
+**Windows Command Prompt (cmd):**
+
+```cmd
+set "MDB_MCP_CONFIG=C:\path\to\config.json"
+npx -y mongodb-mcp-server@latest
+```
+
+**Windows PowerShell:**
+
+```powershell
+$env:MDB_MCP_CONFIG="C:\path\to\config.json"
+npx -y mongodb-mcp-server@latest
+```
+
 #### Environment Variables
 
 Set environment variables with the prefix `MDB_MCP_` followed by the option name in uppercase with underscores:
@@ -639,7 +730,6 @@ npx -y mongodb-mcp-server@latest --logPath=/path/to/logs --readOnly --indexCheck
       "args": [
         "-y",
         "mongodb-mcp-server",
-        "--connectionString",
         "mongodb+srv://username:password@cluster.mongodb.net/myDatabase",
         "--readOnly"
       ]
@@ -678,6 +768,14 @@ connecting to the Atlas API, your MongoDB Cluster, or any other external calls
 to third-party services like OID Providers. The behaviour is the same as what
 `mongosh` does, so the same settings will work in the MCP Server.
 
+## 🚀Deploy on Public Clouds
+
+You can deploy the MongoDB MCP Server to your preferred cloud provider using the deployment assets under `deploy/`. Each guide explains the prerequisites, configuration, and automation scripts that streamline the rollout.
+
+### Azure
+
+For detailed Azure instructions, see [deploy/azure/README.md](deploy/azure/README.md).
+
 ## 🤝Contributing
 
 Interested in contributing? Great! Please check our [Contributing Guide](CONTRIBUTING.md) for guidelines on code contributions, standards, adding new tools, and troubleshooting information.

package/dist/cjs/common/atlas/accessListUtils.js

@@ -24,7 +24,7 @@ async function makeCurrentIpAccessListEntry(apiClient, projectId, comment = expo
 async function ensureCurrentIpInAccessList(apiClient, projectId) {
     const entry = await makeCurrentIpAccessListEntry(apiClient, projectId, exports.DEFAULT_ACCESS_LIST_COMMENT);
     try {
-        await apiClient.createProjectIpAccessList({
+        await apiClient.createAccessListEntry({
             params: { path: { groupId: projectId } },
             body: [entry],
         });

package/dist/cjs/common/atlas/accessListUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"accessListUtils.js","sourceRoot":"","sources":["../../../../src/common/atlas/accessListUtils.ts"],"names":[],"mappings":";;;AAMA,oEAWC;AASD,kEA8BC;AAvDD,4CAAqC;AACrC,2DAAqD;AAExC,QAAA,2BAA2B,GAAG,mDAAmD,CAAC;AAExF,KAAK,UAAU,4BAA4B,CAC9C,SAAoB,EACpB,SAAiB,EACjB,UAAkB,mCAA2B;IAE7C,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAC3D,OAAO;QACH,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,kBAAkB;QAC7B,OAAO;KACV,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,2BAA2B,CAAC,SAAoB,EAAE,SAAiB;IACrF,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,mCAA2B,CAAC,CAAC;IACpG,IAAI,CAAC;QACD,MAAM,SAAS,CAAC,yBAAyB,CAAC;YACtC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;YACxC,IAAI,EAAE,CAAC,KAAK,CAAC;SAChB,CAAC,CAAC;QACH,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;YACnB,EAAE,EAAE,iBAAK,CAAC,sBAAsB;YAChC,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;SAC9D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,kCAAc,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;YAChE,+CAA+C;YAC/C,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;gBACnB,EAAE,EAAE,iBAAK,CAAC,sBAAsB;gBAChC,OAAO,EAAE,iBAAiB;gBAC1B,OAAO,EAAE,cAAc,KAAK,CAAC,SAAS,sDAAsD,SAAS,GAAG;aAC3G,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,iBAAK,CAAC,2BAA2B;YACrC,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC9F,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}
+{"version":3,"file":"accessListUtils.js","sourceRoot":"","sources":["../../../../src/common/atlas/accessListUtils.ts"],"names":[],"mappings":";;;AAMA,oEAWC;AASD,kEA8BC;AAvDD,4CAAqC;AACrC,2DAAqD;AAExC,QAAA,2BAA2B,GAAG,mDAAmD,CAAC;AAExF,KAAK,UAAU,4BAA4B,CAC9C,SAAoB,EACpB,SAAiB,EACjB,UAAkB,mCAA2B;IAE7C,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAC3D,OAAO;QACH,OAAO,EAAE,SAAS;QAClB,SAAS,EAAE,kBAAkB;QAC7B,OAAO;KACV,CAAC;AACN,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,2BAA2B,CAAC,SAAoB,EAAE,SAAiB;IACrF,MAAM,KAAK,GAAG,MAAM,4BAA4B,CAAC,SAAS,EAAE,SAAS,EAAE,mCAA2B,CAAC,CAAC;IACpG,IAAI,CAAC;QACD,MAAM,SAAS,CAAC,qBAAqB,CAAC;YAClC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE;YACxC,IAAI,EAAE,CAAC,KAAK,CAAC;SAChB,CAAC,CAAC;QACH,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;YACnB,EAAE,EAAE,iBAAK,CAAC,sBAAsB;YAChC,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,2BAA2B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;SAC9D,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,IAAI,GAAG,YAAY,kCAAc,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;YAChE,+CAA+C;YAC/C,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC;gBACnB,EAAE,EAAE,iBAAK,CAAC,sBAAsB;gBAChC,OAAO,EAAE,iBAAiB;gBAC1B,OAAO,EAAE,cAAc,KAAK,CAAC,SAAS,sDAAsD,SAAS,GAAG;aAC3G,CAAC,CAAC;YACH,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;YACrB,EAAE,EAAE,iBAAK,CAAC,2BAA2B;YACrC,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,gCAAgC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC9F,CAAC,CAAC;IACP,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC"}

package/dist/cjs/common/atlas/apiClient.d.ts

@@ -2,35 +2,28 @@ import type { FetchOptions } from "openapi-fetch";
 import type { operations } from "./openapi.js";
 import type { CommonProperties, TelemetryEvent } from "../../telemetry/types.js";
 import type { LoggerBase } from "../logger.js";
-export interface ApiClientCredentials {
-    clientId: string;
-    clientSecret: string;
-}
+import type { Credentials, AuthProvider } from "./auth/authProvider.js";
 export interface ApiClientOptions {
-    credentials?: ApiClientCredentials;
     baseUrl: string;
     userAgent?: string;
+    credentials?: Credentials;
+    requestContext?: RequestContext;
 }
-export interface AccessToken {
-    access_token: string;
-    expires_at?: number;
-}
+type RequestContext = {
+    headers?: Record<string, string | string[] | undefined>;
+};
+export type ApiClientFactoryFn = (options: ApiClientOptions, logger: LoggerBase) => ApiClient;
+export declare const createAtlasApiClient: ApiClientFactoryFn;
 export declare class ApiClient {
     readonly logger: LoggerBase;
+    readonly authProvider?: AuthProvider | undefined;
     private readonly options;
-    private static customFetch;
+    private customFetch;
     private client;
-    private oauth2Client?;
-    private oauth2Issuer?;
-    private accessToken?;
-    hasCredentials(): boolean;
-    private isAccessTokenValid;
-    private getAccessToken;
-    private authMiddleware;
-    constructor(options: ApiClientOptions, logger: LoggerBase);
-    private getOauthClientAuth;
-    private getNewAccessToken;
-    validateAccessToken(): Promise<void>;
+    isAuthConfigured(): boolean;
+    constructor(options: ApiClientOptions, logger: LoggerBase, authProvider?: AuthProvider | undefined);
+    private createAuthMiddleware;
+    validateAuthConfig(): Promise<void>;
     close(): Promise<void>;
     getIpInfo(): Promise<{
         currentIpv4Address: string;
@@ -38,17 +31,17 @@ export declare class ApiClient {
     sendEvents(events: TelemetryEvent<CommonProperties>[]): Promise<void>;
     private sendAuthEvents;
     private sendUnauthEvents;
-    listClustersForAllProjects(options?: FetchOptions<operations["listClustersForAllProjects"]>): Promise<{
+    listClusterDetails(options?: FetchOptions<operations["listClusterDetails"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["OrgGroup"][];
         readonly totalCount?: number;
     }>;
-    listProjects(options?: FetchOptions<operations["listProjects"]>): Promise<{
+    listGroups(options?: FetchOptions<operations["listGroups"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["Group"][];
         readonly totalCount?: number;
     }>;
-    createProject(options: FetchOptions<operations["createProject"]>): Promise<{
+    createGroup(options: FetchOptions<operations["createGroup"]>): Promise<{
         readonly clusterCount: number;
         readonly created: string;
         readonly id?: string;
@@ -59,8 +52,8 @@ export declare class ApiClient {
         tags?: import("./openapi.js").components["schemas"]["ResourceTag"][];
         withDefaultAlertsSettings: boolean;
     }>;
-    deleteProject(options: FetchOptions<operations["deleteProject"]>): Promise<void>;
-    getProject(options: FetchOptions<operations["getProject"]>): Promise<{
+    deleteGroup(options: FetchOptions<operations["deleteGroup"]>): Promise<void>;
+    getGroup(options: FetchOptions<operations["getGroup"]>): Promise<{
         readonly clusterCount: number;
         readonly created: string;
         readonly id?: string;
@@ -71,28 +64,28 @@ export declare class ApiClient {
         tags?: import("./openapi.js").components["schemas"]["ResourceTag"][];
         withDefaultAlertsSettings: boolean;
     }>;
-    listProjectIpAccessLists(options: FetchOptions<operations["listProjectIpAccessLists"]>): Promise<{
+    listAccessListEntries(options: FetchOptions<operations["listGroupAccessListEntries"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["NetworkPermissionEntry"][];
         readonly totalCount?: number;
     }>;
-    createProjectIpAccessList(options: FetchOptions<operations["createProjectIpAccessList"]>): Promise<{
+    createAccessListEntry(options: FetchOptions<operations["createGroupAccessListEntry"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["NetworkPermissionEntry"][];
         readonly totalCount?: number;
     }>;
-    deleteProjectIpAccessList(options: FetchOptions<operations["deleteProjectIpAccessList"]>): Promise<void>;
-    listAlerts(options: FetchOptions<operations["listAlerts"]>): Promise<{
+    deleteAccessListEntry(options: FetchOptions<operations["deleteGroupAccessListEntry"]>): Promise<void>;
+    listAlerts(options: FetchOptions<operations["listGroupAlerts"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["AlertViewForNdsGroup"][];
         readonly totalCount?: number;
     }>;
-    listClusters(options: FetchOptions<operations["listClusters"]>): Promise<{
+    listClusters(options: FetchOptions<operations["listGroupClusters"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["ClusterDescription20240805"][];
         readonly totalCount?: number;
     }>;
-    createCluster(options: FetchOptions<operations["createCluster"]>): Promise<{
+    createCluster(options: FetchOptions<operations["createGroupCluster"]>): Promise<{
         acceptDataRisksAndForceReplicaSetReconfig?: string;
         advancedConfiguration?: import("./openapi.js").components["schemas"]["ApiAtlasClusterAdvancedConfigurationView"];
         backupEnabled: boolean;
@@ -109,6 +102,7 @@ export declare class ApiClient {
         globalClusterSelfManagedSharding?: boolean;
         readonly groupId?: string;
         readonly id?: string;
+        readonly internalClusterRole?: "NONE" | "SYSTEM_CLUSTER" | "INTERNAL_SHADOW_CLUSTER";
         labels?: import("./openapi.js").components["schemas"]["ComponentLabel"][];
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         mongoDBEmployeeAccessGrant?: import("./openapi.js").components["schemas"]["EmployeeAccessGrantView"];
@@ -120,14 +114,16 @@ export declare class ApiClient {
         redactClientLogData?: boolean;
         replicaSetScalingStrategy: "SEQUENTIAL" | "WORKLOAD_TYPE" | "NODE_TYPE";
         replicationSpecs?: import("./openapi.js").components["schemas"]["ReplicationSpec20240805"][];
+        retainBackups: boolean;
         rootCertType: "ISRGROOTX1";
         readonly stateName?: "IDLE" | "CREATING" | "UPDATING" | "DELETING" | "REPAIRING";
         tags?: import("./openapi.js").components["schemas"]["ResourceTag"][];
         terminationProtectionEnabled: boolean;
+        useAwsTimeBasedSnapshotCopyForFastInitialSync: boolean;
         versionReleaseSystem: "LTS" | "CONTINUOUS";
     }>;
-    deleteCluster(options: FetchOptions<operations["deleteCluster"]>): Promise<void>;
-    getCluster(options: FetchOptions<operations["getCluster"]>): Promise<{
+    deleteCluster(options: FetchOptions<operations["deleteGroupCluster"]>): Promise<void>;
+    getCluster(options: FetchOptions<operations["getGroupCluster"]>): Promise<{
         acceptDataRisksAndForceReplicaSetReconfig?: string;
         advancedConfiguration?: import("./openapi.js").components["schemas"]["ApiAtlasClusterAdvancedConfigurationView"];
         backupEnabled: boolean;
@@ -144,6 +140,7 @@ export declare class ApiClient {
         globalClusterSelfManagedSharding?: boolean;
         readonly groupId?: string;
         readonly id?: string;
+        readonly internalClusterRole?: "NONE" | "SYSTEM_CLUSTER" | "INTERNAL_SHADOW_CLUSTER";
         labels?: import("./openapi.js").components["schemas"]["ComponentLabel"][];
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         mongoDBEmployeeAccessGrant?: import("./openapi.js").components["schemas"]["EmployeeAccessGrantView"];
@@ -155,18 +152,32 @@ export declare class ApiClient {
         redactClientLogData?: boolean;
         replicaSetScalingStrategy: "SEQUENTIAL" | "WORKLOAD_TYPE" | "NODE_TYPE";
         replicationSpecs?: import("./openapi.js").components["schemas"]["ReplicationSpec20240805"][];
+        retainBackups: boolean;
         rootCertType: "ISRGROOTX1";
         readonly stateName?: "IDLE" | "CREATING" | "UPDATING" | "DELETING" | "REPAIRING";
         tags?: import("./openapi.js").components["schemas"]["ResourceTag"][];
         terminationProtectionEnabled: boolean;
+        useAwsTimeBasedSnapshotCopyForFastInitialSync: boolean;
         versionReleaseSystem: "LTS" | "CONTINUOUS";
     }>;
-    listDatabaseUsers(options: FetchOptions<operations["listDatabaseUsers"]>): Promise<{
+    listDropIndexSuggestions(options: FetchOptions<operations["listGroupClusterPerformanceAdvisorDropIndexSuggestions"]>): Promise<{
+        readonly hiddenIndexes?: import("./openapi.js").components["schemas"]["DropIndexSuggestionsIndex"][];
+        readonly redundantIndexes?: import("./openapi.js").components["schemas"]["DropIndexSuggestionsIndex"][];
+        readonly unusedIndexes?: import("./openapi.js").components["schemas"]["DropIndexSuggestionsIndex"][];
+    }>;
+    listSchemaAdvice(options: FetchOptions<operations["listGroupClusterPerformanceAdvisorSchemaAdvice"]>): Promise<{
+        readonly recommendations?: import("./openapi.js").components["schemas"]["SchemaAdvisorItemRecommendation"][];
+    }>;
+    listClusterSuggestedIndexes(options: FetchOptions<operations["listGroupClusterPerformanceAdvisorSuggestedIndexes"]>): Promise<{
+        readonly shapes?: import("./openapi.js").components["schemas"]["PerformanceAdvisorShape"][];
+        readonly suggestedIndexes?: import("./openapi.js").components["schemas"]["PerformanceAdvisorIndex"][];
+    }>;
+    listDatabaseUsers(options: FetchOptions<operations["listGroupDatabaseUsers"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["CloudDatabaseUser"][];
         readonly totalCount?: number;
     }>;
-    createDatabaseUser(options: FetchOptions<operations["createDatabaseUser"]>): Promise<{
+    createDatabaseUser(options: FetchOptions<operations["createGroupDatabaseUser"]>): Promise<{
         awsIAMType: "NONE" | "USER" | "ROLE";
         databaseName: "admin" | "$external";
         deleteAfterDate?: string;
@@ -182,13 +193,13 @@ export declare class ApiClient {
         username: string;
         x509Type: "NONE" | "CUSTOMER" | "MANAGED";
     }>;
-    deleteDatabaseUser(options: FetchOptions<operations["deleteDatabaseUser"]>): Promise<void>;
-    listFlexClusters(options: FetchOptions<operations["listFlexClusters"]>): Promise<{
+    deleteDatabaseUser(options: FetchOptions<operations["deleteGroupDatabaseUser"]>): Promise<void>;
+    listFlexClusters(options: FetchOptions<operations["listGroupFlexClusters"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["FlexClusterDescription20241113"][];
         readonly totalCount?: number;
     }>;
-    createFlexCluster(options: FetchOptions<operations["createFlexCluster"]>): Promise<{
+    createFlexCluster(options: FetchOptions<operations["createGroupFlexCluster"]>): Promise<{
         backupSettings?: import("./openapi.js").components["schemas"]["FlexBackupSettings20241113"];
         readonly clusterType: "REPLICASET";
         connectionStrings?: import("./openapi.js").components["schemas"]["FlexConnectionStrings20241113"];
@@ -204,8 +215,8 @@ export declare class ApiClient {
         terminationProtectionEnabled: boolean;
         readonly versionReleaseSystem: "LTS";
     }>;
-    deleteFlexCluster(options: FetchOptions<operations["deleteFlexCluster"]>): Promise<void>;
-    getFlexCluster(options: FetchOptions<operations["getFlexCluster"]>): Promise<{
+    deleteFlexCluster(options: FetchOptions<operations["deleteGroupFlexCluster"]>): Promise<void>;
+    getFlexCluster(options: FetchOptions<operations["getGroupFlexCluster"]>): Promise<{
         backupSettings?: import("./openapi.js").components["schemas"]["FlexBackupSettings20241113"];
         readonly clusterType: "REPLICASET";
         connectionStrings?: import("./openapi.js").components["schemas"]["FlexConnectionStrings20241113"];
@@ -221,15 +232,19 @@ export declare class ApiClient {
         terminationProtectionEnabled: boolean;
         readonly versionReleaseSystem: "LTS";
     }>;
-    listOrganizations(options?: FetchOptions<operations["listOrganizations"]>): Promise<{
+    listSlowQueryLogs(options: FetchOptions<operations["listGroupProcessPerformanceAdvisorSlowQueryLogs"]>): Promise<{
+        readonly slowQueries?: import("./openapi.js").components["schemas"]["PerformanceAdvisorSlowQuery"][];
+    }>;
+    listOrgs(options?: FetchOptions<operations["listOrgs"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["AtlasOrganization"][];
         readonly totalCount?: number;
     }>;
-    listOrganizationProjects(options: FetchOptions<operations["listOrganizationProjects"]>): Promise<{
+    getOrgGroups(options: FetchOptions<operations["getOrgGroups"]>): Promise<{
         readonly links?: import("./openapi.js").components["schemas"]["Link"][];
         readonly results?: import("./openapi.js").components["schemas"]["Group"][];
         readonly totalCount?: number;
     }>;
 }
+export {};
 //# sourceMappingURL=apiClient.d.ts.map