Model Context Protocol (MCP) is a standard for connecting large language models to external software, services, and data sources.
The MongoDB MCP Server allows you to interact with MongoDB clusters using natural language queries from AI clients that support MCP. The MCP Server provides tools that perform cluster operations.
This page describes the MCP Server tools.
Details
MCP Server tool categories:
Atlas tools, which perform operations on Atlas system resources, like organizations, projects, clusters, database user accounts, and others.
Database tools, which perform operations such as inserting, updating, and deleting documents, and running queries and aggregation pipelines.
MCP Server Atlas Tools
The Atlas tools are only available if you have set up Atlas API credentials as shown in MongoDB MCP Server Configuration.
The following table describes the Atlas tools:
MCP Server Atlas Tool Name | Description |
---|---|
| Returns a list of Atlas organizations. |
| Returns a list of Atlas projects. |
| Creates a new Atlas project. |
| Returns list of Atlas clusters. |
| Returns information about a specific Atlas cluster. |
| Creates a free Atlas cluster. |
| Connects to an Atlas cluster using the configured service account. If you configured the MCP server without specifying a connection string, this tool creates a temporary database user with a random password to establish the connection. For details, see Considerations. |
| Returns information about the IP and CIDR ranges that can access an Atlas cluster. |
| Configures the IP and CIDR access list for an Atlas cluster. |
| Returns a list of Atlas database users. |
| Creates an Atlas database user. |
| Returns a list of alerts for an Atlas project. |
MCP Server Database Tools
The following table describes the database tools:
MCP Server Database Tool Name | Description |
---|---|
| Connects to a cluster. |
| Runs a database query. |
| Runs an aggregation pipeline. |
| Returns the number of documents in a collection. |
| Adds a single document to a collection. |
| Adds multiple documents to a collection. |
| Adds an index to a collection. |
| Modifies a single document in a collection. |
| Modifies multiple documents in a collection. |
| Changes the name of a collection. |
| Removes a single document from a collection. |
| Removes multiple documents from a collection. |
| Deletes a collection from a database. |
| Deletes a database. |
| Returns a list of all databases available through the current connection. |
| Returns a list of collections in a database. |
| Returns information about collection indexes. |
| Returns collection schema information. |
| Returns collection size in megabytes. |
| Returns database statistics. |
| Saves the results of a query or aggregation pipeline in JSON
format to a file on the computer that runs the MCP Server.
The results are also accessible through the |
Considerations
If you configured the MCP server without specifying a connection string
to an Atlas cluster, the atlas-connect-cluster
tool
creates a temporary database user
to establish connection to the cluster
by using the configured Atlas API service account credentials.
The temporary database user has the following characteristics:
Randomly generated username and password.
Automatically expires after 12 hours.
Role assigned based on how you configured the MCP Server:
readAnyDatabase
if you enabled read-only mode or disabled thecreate
,delete
, andupdate
tool categories.readWriteAnyDatabase
if the server has full permissions.
Note
User credentials are stored only in the MCP Server's memory and are never returned to or exposed in the LLM context.
Learn More
To disable specific tools and restrict the MCP Server to read-only mode, see MongoDB MCP Server Configuration.
To see some MCP Server example natural language prompts, see MongoDB MCP Server Usage Examples.