Tools on MCP Toolbox for Databases

mongodb-aggregate

Mon, 01 Jan 0001 00:00:00 +0000

About

The mongodb-aggregate tool is the most powerful query tool for MongoDB, allowing you to process data through a multi-stage pipeline. Each stage transforms the documents as they pass through, enabling complex operations like grouping, filtering, reshaping documents, and performing calculations.

The core of this tool is the pipelinePayload, which must be a string containing a JSON array of pipeline stage documents. The tool returns a JSON array of documents produced by the final stage of the pipeline.

mongodb-delete-many

Mon, 01 Jan 0001 00:00:00 +0000

About

The mongodb-delete-many tool performs a bulk destructive operation, deleting ALL documents from a collection that match a specified filter.

The tool returns the total count of documents that were deleted. If the filter does not match any documents (i.e., the deleted count is 0), the tool will return an error.

Compatible Sources

This tool can be used with the following database sources:

Source Name
MongoDB

Example

Here is an example that performs a cleanup task by deleting all products from the inventory collection that belong to a discontinued brand.

mongodb-delete-one

Mon, 01 Jan 0001 00:00:00 +0000

About

The mongodb-delete-one tool performs a destructive operation, deleting the first single document that matches a specified filter from a MongoDB collection.

If the filter matches multiple documents, only the first one found by the database will be deleted. This tool is useful for removing specific entries, such as a user account or a single item from an inventory based on a unique ID.

The tool returns the number of documents deleted, which will be either 1 if a document was found and deleted, or 0 if no matching document was found.

mongodb-find

Mon, 01 Jan 0001 00:00:00 +0000

About

A mongodb-find tool is used to query a MongoDB collection and retrieve documents that match a specified filter. It’s a flexible tool that allows you to shape the output by selecting specific fields (projection), ordering the results (sorting), and restricting the number of documents returned (limiting).

The tool returns a JSON array of the documents found.

Compatible Sources

This tool can be used with the following database sources:

Source Name
MongoDB

Example

Here’s an example that finds up to 10 users from the customers collection who live in a specific city. The results are sorted by their last name, and only their first name, last name, and email are returned.

mongodb-find-one

Mon, 01 Jan 0001 00:00:00 +0000

About

A mongodb-find-one tool is used to retrieve the first single document that matches a specified filter from a MongoDB collection. If multiple documents match the filter, you can use sort options to control which document is returned. Otherwise, the selection is not guaranteed.

The tool returns a single JSON object representing the document, wrapped in a JSON array.

Compatible Sources

This tool can be used with the following database sources:

mongodb-insert-many

Mon, 01 Jan 0001 00:00:00 +0000

About

The mongodb-insert-many tool inserts multiple new documents into a specified MongoDB collection in a single bulk operation. This is highly efficient for adding large amounts of data at once.

This tool takes one required parameter named data. This data parameter must be a string containing a JSON array of document objects. Upon successful insertion, the tool returns a JSON array containing the unique _id of each new document that was created.

mongodb-insert-one

Mon, 01 Jan 0001 00:00:00 +0000

About

The mongodb-insert-one tool inserts a single new document into a specified MongoDB collection.

This tool takes one required parameter named data, which must be a string containing the JSON object you want to insert. Upon successful insertion, the tool returns the unique _id of the newly created document.

Compatible Sources

This tool can be used with the following database sources:

Source Name
MongoDB

Example

Here is an example configuration for a tool that adds a new user to a users collection.

mongodb-update-many

Mon, 01 Jan 0001 00:00:00 +0000

About

A mongodb-update-many tool updates all documents within a specified MongoDB collection that match a given filter. It locates the documents using a filterPayload and applies the modifications defined in an updatePayload.

The tool returns an array of three integers: [ModifiedCount, UpsertedCount, MatchedCount].

Compatible Sources

This tool can be used with the following database sources:

Source Name
MongoDB

Example

Here’s an example configuration. This tool applies a discount to all items within a specific category and also marks them as being on sale.

mongodb-update-one

Mon, 01 Jan 0001 00:00:00 +0000

About

A mongodb-update-one tool updates a single document within a specified MongoDB collection. It locates the document to be updated using a filterPayload and applies modifications defined in an updatePayload. If the filter matches multiple documents, only the first one found will be updated.

Compatible Sources

This tool can be used with the following database sources:

Source Name
MongoDB

Example

Here’s an example of a mongodb-update-one tool configuration. This tool updates the stock and status fields of a document in the inventory collection where the item field matches a provided value. If no matching document is found, the upsert: true option will create a new one.