MongoDB Atlas MCP Server
for AI Agents

Creates a new alert configuration (rule) in an Atlas project, defining the event that triggers an alert and where notifications are sent.

Lists all alert configurations (the rules defining alert triggers and notification targets) for the given Atlas project.

Retrieves a single alert configuration (rule) from an Atlas project by its alert configuration ID.

Replaces an existing alert configuration (rule) in an Atlas project by its ID, overwriting the trigger event, thresholds, matchers, and notification targets.

Permanently deletes an alert configuration (rule) from an Atlas project by its alert configuration ID.

Lists all fired alerts in one Atlas project (GET /groups/{groupId}/alerts). An alert fires when a monitored component crosses a threshold; filter by status (OPEN, TRACKING, CLOSED) to narrow results.

Retrieves one fired alert by its ID within an Atlas project (GET /groups/{groupId}/alerts/{alertId}), including its status, trigger metric, and acknowledgement state.

Creates a new programmatic organization API key in a MongoDB Atlas organization (orgId), requiring a description and at least one role; returns the private key only once.

Lists all programmatic organization API keys in a MongoDB Atlas organization (orgId), returning each key's ID, description, and assigned roles.

Retrieves a single organization API key by its apiUserId within a MongoDB Atlas organization (orgId), returning its description and assigned roles.

Permanently deletes an organization API key (apiUserId) from a MongoDB Atlas organization (orgId), immediately revoking its programmatic access everywhere it is used.

Takes one on-demand cloud backup SNAPSHOT of a cluster immediately (outside the scheduled backup policy), returning the new snapshot's ID and initial status.

Lists all cloud backup SNAPSHOTS (point-in-time copies of stored data) for one cluster in a project, returning each snapshot's ID, creation time, status, size, and retention.

Retrieves one cloud backup SNAPSHOT by its snapshotId, returning its full metadata (creation time, status, size, retention, and replica-set details).

Creates a backup RESTORE JOB that recovers a cluster's data from a snapshot, either restoring into a target cluster (automated/pointInTime) or producing a downloadable archive (download).

Lists all cloud backup RESTORE JOBS for one cluster in a project, showing each recovery operation's status, delivery type, target cluster, and the snapshot it restores.

Invites a human user (new or existing MongoDB Cloud account) to join an organization with the given roles, creating a PENDING membership until the invitee accepts.

Lists the human MongoDB Cloud USERS (both active and pending-invitation) that belong to an organization, returning each user's ID, username/email, roles, teams, and membership status.

Retrieves one human MongoDB Cloud USER by userId within an organization, returning their username/email, org roles, team memberships, and membership status.

Updates one human MongoDB Cloud USER in an organization (active or still pending), changing their org roles and/or team memberships.

Provisions a new database cluster in a project (groupId), with its topology, region, instance size, MongoDB version, and backup options defined in replicationSpecs. The call returns quickly with the cluster in a CREATING state before provisioning finishes.

Lists all dedicated and Flex database clusters within a single project (groupId), returning each cluster's name, instance size, MongoDB version, state, region config, and connection strings.

Retrieves the full details of a single cluster by project (groupId) and clusterName, including its current state, instance size, MongoDB version, region/shard configuration, and connection strings.

Modifies an existing cluster identified by groupId and clusterName — for example to scale the instance size, change the MongoDB version, toggle backups, pause/resume, or adjust termination protection. Only the fields you supply are changed, and the change applies asynchronously.

Permanently deletes a single cluster (by groupId and clusterName) and its data, leaving the parent project intact. Runs asynchronously and requires termination protection to be disabled first.

Creates a new custom database role in an Atlas project, defining its privilege actions and/or the built-in roles it inherits.

Lists all custom database roles defined in the given Atlas project (groupId), including their granted privilege actions and inherited roles.

Retrieves a single custom database role from an Atlas project by its role name, including its privilege actions and inherited roles.

Updates an existing custom database role in an Atlas project (by role name), replacing its privilege actions and inherited roles.

Permanently deletes a custom database role from an Atlas project by its role name.

Creates a new database user (a data-plane credential) in an Atlas project with the given username, authentication database, and role-to-database pairings.

Lists every database user in the given Atlas project (groupId), returning their username, authentication database, roles, and scopes.

Retrieves a single database user from an Atlas project, identified by its authentication database and username.

Updates an existing database user in an Atlas project (identified by authentication database + username), fully replacing its roles and scopes with the values sent.

Permanently deletes a database user from an Atlas project, identified by its authentication database and username.

Creates a new MongoDB Atlas flex cluster in a project (groupId), requiring a cluster name and providerSettings (cloud provider and region).

Lists all MongoDB Atlas flex clusters in a project (groupId), returning each cluster's name, state, and connection details.

Retrieves a single MongoDB Atlas flex cluster by its name within a project (groupId), returning its state, provider settings, and connection strings.

Permanently deletes a MongoDB Atlas flex cluster by name from a project (groupId), destroying the instance and its data; termination protection must be disabled first.

Creates a new MongoDB Atlas organization and links it under the calling credential's existing (paying) organization, returning the new orgId. Requires a name; optionally provisions an owner and a fresh API key or service account for the new org.

Lists every MongoDB Atlas organization the authenticated Service Account or API Key can access, returning each organization's id (orgId), name, and status. Optionally filter by a name prefix.

Retrieves the details of a single MongoDB Atlas organization by its orgId, including name, status, and account-level settings.

Updates a MongoDB Atlas organization identified by orgId — primarily its human-readable name and its default-alert-creation behavior — and returns the updated organization.

Adds one or more IP access list entries to a project so clients from those sources can connect to its clusters, taking an `entries` ARRAY where each item specifies exactly one source.

Lists all IP access list entries for a project — the IP addresses, CIDR blocks, and AWS security groups from which Atlas permits client connections to the project's clusters.

Retrieves one IP access list entry from a project by its entry value (an IP address, CIDR block, or AWS security group ID), returning its comment, timestamps, and any temporary-expiry date.

Removes one IP access list entry from a project by its entry value, revoking cluster network access from that IP address, CIDR block, or AWS security group.

Creates a new MongoDB Atlas project (a.k.a. "group") inside an existing organization and returns it with its newly assigned groupId. Requires name and orgId; the project starts empty (no clusters).

Lists every MongoDB Atlas project (called a "group" in the API) that the authenticated Service Account or API Key can access, across all organizations, returning each project's id (groupId), name, orgId, cluster count, and creation date.

Retrieves the full details of a single MongoDB Atlas project (a.k.a. "group") by its groupId, including name, orgId, cluster count, creation date, tags, and alert settings.

Updates a project's mutable settings by groupId — its human-readable name, its tags, and whether default alerts are auto-created — and returns the updated project. Only the fields you supply are changed.

Permanently deletes an entire MongoDB Atlas project (group) by groupId, along with everything it contains. Succeeds only if the project has no Online Archives on its clusters.

Creates a new team in a MongoDB Atlas organization (orgId), requiring a name and an initial list of member usernames.

Lists all teams in a MongoDB Atlas organization (identified by orgId), returning each team's ID, name, and member count.

Retrieves a single MongoDB Atlas team by its teamId within the given organization (orgId), returning the team's name and details.

Permanently deletes a MongoDB Atlas team (teamId) from an organization (orgId), immediately revoking the project access it granted its members.