MongoDB
Tools to query and explore a MongoDB database
1.1.0The MongoDB toolkit connects Arcade to a MongoDB instance, enabling agents and tools to explore, query, and aggregate data across databases and collections.
Capabilities
- Discovery: Enumerate all databases in a MongoDB instance and all collections within a database before any query is executed.
- Schema inference: Sample documents from a collection to infer field names and data types, required before running any query (MongoDB is schema-less).
- Document retrieval & counting: Find documents with full MongoDB query operator support (
$gte,$lte,$in,$regex, etc.) with projection and sorting, and count documents matching a filter. - Aggregation pipelines: Execute multi-stage aggregation pipelines (
$match,$group,$project,$sort,$limit,$lookup, and more) for complex data processing and cross-collection joins.
Secrets
MONGODB_CONNECTION_STRING — The full MongoDB connection URI used to authenticate and connect to your MongoDB instance. The format is typically mongodb://username:password@host:port/database for self-hosted deployments or mongodb+srv://username:password for MongoDB Atlas. Obtain it from your MongoDB Atlas dashboard under Database → Connect → Drivers (choose "Python" or any driver; the URI is the same), or construct it manually for self-hosted deployments using your host, port, and credentials. The URI must include credentials with at least read access to the target databases and collections; grant only the minimum required privileges via MongoDB's role-based access control.
For Atlas, see the official docs: Get Connection String – Atlas.
Configure this secret in Arcade following the Arcade secrets guide, or add it directly at https://api.arcade.dev/dashboard/auth/secrets.
Available tools(6)
| Tool name | Description | Secrets | |
|---|---|---|---|
Execute a MongoDB aggregation pipeline on a collection.
ONLY use this tool if you have already loaded the schema of the collection you need to query.
Load the collection's schema first if it is not already known.
Returns a list of JSON strings, where each string represents a
result document from the aggregation
(tools cannot return complex types).
Aggregation pipelines allow for complex data processing including:
* $match - filter documents
* $group - group documents and perform calculations
* $project - reshape documents
* $sort - sort documents
* $limit - limit results
* $lookup - join with other collections
* And many more stages | 1 | ||
Count documents in a MongoDB collection matching the given filter. | 1 | ||
Discover all the collections in the MongoDB database.
Use when the list of collections is not known.
ALWAYS use this tool before any other tool that requires a collection name. | 1 | ||
Discover all the databases in the MongoDB instance. | 1 | ||
Find documents in a MongoDB collection.
ONLY use this tool if you have already loaded the schema of the collection you need to query.
Load the collection's schema first if it is not already known.
Returns a list of JSON strings, where each string represents a
document from the collection (tools cannot return complex types).
When running queries, follow these rules which will help avoid errors:
* Always specify projection to limit fields returned if you don't need all data.
* Always sort your results by the most relevant fields first. Use '_id' if you're unsure.
* Use appropriate MongoDB query operators for complex filtering ($gte, $lte, $in, $regex, etc.).
* Be mindful of case sensitivity when querying string fields.
* Use indexes when possible (typically on _id and commonly queried fields). | 1 | ||
Get the schema/structure of a MongoDB collection by sampling documents.
Since MongoDB is schema-less, this tool samples a configurable number of documents
to infer the schema structure and data types.
This tool should ALWAYS be used before executing any query.
All collections in the query must be discovered first by listing the database's collections. | 1 |