aggregate
ChatGPTRun an aggregation against a MongoDB collection
Overview
Manage MongoDB Atlas and query your data directly through Claude. Connect to any MongoDB cluster or Atlas project to run queries and aggregations, inspect schemas and indexes, and read/write documents - all through natural language. Key features: Query and manage data - Run finds, aggregations, and counts; insert, update, or delete documents; create collections and indexes. Manage Atlas infrastructure - Create and upgrade clusters, manage database users and IP access lists, and inspect cluster metadata across your projects and organizations. Optimize performance - Get index suggestions, schema recommendations, and slow query analysis from the Atlas Performance Advisor. Build streaming pipelines - Create, monitor, and manage Atlas Stream Processing workspaces, connections, and processors. * Search MongoDB knowledge - Query official MongoDB documentation and expert guidance directly from the assistant knowledge base.
Tools
aggregate-db
ChatGPTRun an aggregation against a MongoDB database
atlas-create-access-list
ChatGPTAllow Ip/CIDR ranges to access your MongoDB Atlas clusters.
atlas-create-cluster
ChatGPTCreate a MongoDB Atlas cluster (M10–M80, replica set or single shard). Compute autoscaling is enabled by default: min instance size is set to the selected instance size, max is set two tiers above. Disk autoscaling is always enabled. The tool returns immediately, use the atlas-inspect-cluster tool to poll the cluster state for readiness (state: IDLE). Connection strings are unavailable until the cluster reaches IDLE state. Note to LLM: Omit instance size unless specified by the user. If provider and region are not already known, ask for both together in a single question before calling this tool. Common, non-exhaustive region default mappings by provider: AWS: "East Coast"/"Virginia"/"US East" → US_EAST_1, "Ohio" → US_EAST_2, "California"/"West Coast" → US_WEST_2, "Southeast Asia"/"APAC"/"Singapore" → AP_SOUTHEAST_1, "Europe"/"EU"/"Ireland" → EU_WEST_1. GCP: "Central US" → CENTRAL_US, "Western US" → WESTERN_US, "Southeast Asia"/"APAC" → SOUTHEASTERN_ASIA_PACIFIC, "Europe"/"EU" → WESTERN_EUROPE. AZURE: "East US" → US_EAST_2, "West US" → US_WEST_2, "Europe North" → EUROPE_NORTH, "Europe West" → EUROPE_WEST. Default recommendation: AWS US_EAST_1. User-specified regions not present in the mapping MUST be respected, rely on the tool to surface errors if a region is not supported.
atlas-create-db-user
ChatGPTCreate an MongoDB Atlas database user
atlas-create-free-cluster
ChatGPTCreate a free MongoDB Atlas cluster
atlas-create-project
ChatGPTCreate a MongoDB Atlas project
atlas-get-performance-advisor
ChatGPTGet 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-get-regions
ChatGPTList supported MongoDB Atlas regions for a cloud provider.
atlas-inspect-access-list
ChatGPTInspect Ip/CIDR ranges with access to your MongoDB Atlas clusters.
atlas-inspect-cluster
ChatGPTInspect metadata of a MongoDB Atlas cluster
atlas-list-alerts
ChatGPTList triggered alerts for a MongoDB Atlas project. These are alerts Atlas has raised, not the alert configurations that define them. Defaults to OPEN alerts; set status to TRACKING or CLOSED to see others.
atlas-list-clusters
ChatGPTList MongoDB Atlas clusters
atlas-list-db-users
ChatGPTList MongoDB Atlas database users
atlas-list-orgs
ChatGPTList MongoDB Atlas organizations
atlas-list-projects
ChatGPTList MongoDB Atlas projects.
atlas-load-sample-dataset
ChatGPTLoad a MongoDB sample dataset into an Atlas cluster, or check the status of a previously-initiated load. To start a new load, provide
clusterName — the load runs asynchronously and the response includes a jobId and initial state. To check progress, call this tool again with jobId (sample dataset loads typically take 1–5 minutes). State can be WORKING, COMPLETED, or FAILED.atlas-pause-resume-cluster
ChatGPTPause or resume a dedicated (M10+) MongoDB Atlas cluster (Free and Flex clusters cannot be paused). Pause: paused clusters are unavailable for connections and do not incur compute costs. If the cluster being paused is the current active connection, it will be automatically disconnected. Returns an error if the cluster is already paused or not in a pausable state (must be IDLE). Resume: the cluster will not be immediately available after resuming. Use the atlas-inspect-cluster tool to poll the cluster state for readiness (state: IDLE). If the cluster is not paused, resuming it is a no-op.
atlas-streams-build
ChatGPTCreate Atlas Stream Processing resources. Use this tool for 'set up a Kafka pipeline', 'create a workspace', 'add a connection', or 'deploy a processor'. Use resource='workspace' to create a new workspace (specify cloud provider, region, and tier). Use resource='connection' to add a data source or sink to an existing workspace. Use resource='processor' to deploy a stream processor with a pipeline. Use resource='privatelink' to set up private networking. Typical workflow: create workspace → add connections → deploy processor.
atlas-streams-discover
ChatGPTDiscover and inspect Atlas Stream Processing resources. Also use for 'why is my processor failing', 'what workspaces do I have', 'show processor stats', or 'check processor health'. Use 'list-workspaces' to see all workspaces in a project. Use inspect actions for details on a specific resource. Use 'diagnose-processor' for a combined health report including state, stats, connection health, and recent errors. Use 'get-networking' for PrivateLink and account details.
atlas-streams-manage
ChatGPTManage Atlas Stream Processing resources: start/stop processors, modify pipelines, update configurations. Also use for 'change the pipeline', 'scale up my processor', or 'update my workspace tier'. Common workflow: action='stop-processor' → action='modify-processor' → action='start-processor'. Use
atlas-streams-discover with action 'inspect-processor' to check state before managing.atlas-streams-teardown
ChatGPTDelete Atlas Stream Processing resources. Also use for 'remove my workspace', 'disconnect a source', 'delete all processors', or 'clean up my streams environment'. Performs basic safety checks before deletion: summarizes counts of processors and connections, highlights connections referenced by processors where possible, and surfaces API errors if processors are still running when deletion is attempted. Use
atlas-streams-discover to review resources before deleting.atlas-upgrade-cluster
ChatGPTUpgrade a MongoDB Atlas cluster tier. Upgrades Free (M0) clusters to Flex or M10 Dedicated, or Flex clusters to M10 Dedicated. The upgrade path is determined automatically from the current tier unless overridden with targetTier. Note to LLM: If provider and region are not already known, ask for both together in a single question before calling this tool. Common region mappings by provider (default recommendation: AWS US_EAST_1): AWS: "East Coast"/"Virginia"/"US East" → US_EAST_1, "Ohio" → US_EAST_2, "California"/"West Coast" → US_WEST_2, "Southeast Asia"/"APAC"/"Singapore" → AP_SOUTHEAST_1, "Europe"/"EU"/"Ireland" → EU_WEST_1. GCP: "Central US" → CENTRAL_US, "Western US" → WESTERN_US, "Southeast Asia"/"APAC" → SOUTHEASTERN_ASIA_PACIFIC, "Europe"/"EU" → WESTERN_EUROPE. AZURE: "East US" → US_EAST_2, "West US" → US_WEST_2, "Europe"/"EU" → EUROPE_NORTH.
collection-indexes
ChatGPTDescribe the indexes for a collection
collection-schema
ChatGPTDescribe the schema for a collection
collection-storage-size
ChatGPTGets the size of the collection
count
ChatGPTGets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter
create-collection
ChatGPTCreates a new collection in a database. If the database doesn't exist, it will be created automatically.
create-index
ChatGPTCreate an index for a collection
db-stats
ChatGPTReturns statistics that reflect the use state of a single database
delete-many
ChatGPTRemoves all documents that match the filter from a MongoDB collection
drop-collection
ChatGPTRemoves a collection or view from the database. The method also removes any indexes associated with the dropped collection.
drop-database
ChatGPTRemoves the specified database, deleting the associated data files
drop-index
ChatGPTDrop an index for the provided database and collection.
explain
ChatGPTReturns statistics describing the execution of the winning plan chosen by the query optimizer for the evaluated method
find
ChatGPTRun a find query against a MongoDB collection
insert-many
ChatGPTInsert 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
ChatGPTList all collections for a given database
list-databases
ChatGPTList all databases for a MongoDB connection
remote-atlas-connect
ChatGPTConnect to MongoDB Atlas cluster
rename-collection
ChatGPTRenames a collection in a MongoDB database
update-many
ChatGPTUpdates 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.
aggregate
Claudeaggregate-db
Claudeatlas-create-access-list
Claudeatlas-create-cluster
Claudeatlas-create-db-user
Claudeatlas-create-free-cluster
Claudeatlas-create-project
Claudeatlas-get-performance-advisor
Claudeatlas-inspect-access-list
Claudeatlas-inspect-cluster
Claudeatlas-list-alerts
Claudeatlas-list-clusters
Claudeatlas-list-db-users
Claudeatlas-list-orgs
Claudeatlas-list-projects
Claudeatlas-load-sample-dataset
Claudeatlas-pause-resume-cluster
Claudeatlas-streams-build
Claudeatlas-streams-discover
Claudeatlas-streams-manage
Claudeatlas-streams-teardown
Claudeatlas-upgrade-cluster
Claudecollection-indexes
Claudecollection-schema
Claudecollection-storage-size
Claudecount
Claudecreate-collection
Claudecreate-index
Claudedb-stats
Claudedelete-many
Claudedrop-collection
Claudedrop-database
Claudedrop-index
Claudeexplain
Claudefind
Claudeinsert-many
Claudelist-collections
Claudelist-databases
Clauderemote-atlas-connect
Clauderename-collection
Claudeupdate-many
ClaudeCapabilities
Writes
