database
MongoDB Atlas CLI for Shell Scripts
Use the MongoDB Atlas CLI for shell scripts with headless JSON commands, schema discovery, credentials, and permission controls.
9 functions 5 read 4 write API key auth
MongoDB Atlas CLI for Shell Scripts
Call integration functions from shell scripts with stable JSON input and output.
Use shell scripts for small local automations that need one or more integration calls. The MongoDB Atlas CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# MongoDB Atlas CLI for Shell Scripts
kosmokrator integrations:configure mongodb --set api_key="$MONGODB_API_KEY" --set cluster_url="$MONGODB_CLUSTER_URL" --enable --read allow --write ask --json
kosmo integrations:call mongodb.mongodb_find '{"database":"example_database","collection":"example_collection","filter":"example_filter","projection":"example_projection","sort":"example_sort","limit":1,"skip":1}' --jsonDiscovery Before Execution
Agents and scripts can inspect MongoDB Atlas docs and schemas before choosing a function.
kosmo integrations:docs mongodb --json
kosmo integrations:docs mongodb.mongodb_find --json
kosmo integrations:schema mongodb.mongodb_find --json
kosmo integrations:search "MongoDB Atlas" --json
kosmo integrations:list --jsonUseful MongoDB Atlas CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
mongodb.mongodb_find | Read | database, collection, filter, projection, sort, limit, skip | Query documents from a MongoDB Atlas collection. Supports filtering, projection, sorting, pagination (limit/skip). Returns an array of matching documents. |
mongodb.mongodb_find_one | Read | database, collection, filter, projection | Find a single document in a MongoDB Atlas collection. Returns the first matching document or null if no match is found. |
mongodb.mongodb_insert_one | Write | database, collection, document | Insert a single document into a MongoDB Atlas collection. Returns the inserted document ID. |
mongodb.mongodb_insert_many | Write | database, collection, documents | Insert multiple documents into a MongoDB Atlas collection in a single operation. Returns the inserted document IDs. |
mongodb.mongodb_update_one | Write | database, collection, filter, update | Update a single document in a MongoDB Atlas collection. Uses a filter to match the document and an update operations object (e.g., {"$set": {"field": "value"}}). |
mongodb.mongodb_delete_one | Write | database, collection, filter | Delete a single document from a MongoDB Atlas collection. Uses a filter to match the document to delete. |
mongodb.mongodb_aggregate | Read | database, collection, pipeline | Run an aggregation pipeline on a MongoDB Atlas collection. Supports all pipeline stages ($match, $group, $sort, $project, $limit, $lookup, etc.). |
mongodb.mongodb_list_collections | Read | database | List all collections in a MongoDB Atlas database. Useful for discovering what data is available before running queries. |
mongodb.mongodb_get_current_user | Read | none | Verify connectivity to MongoDB Atlas and get current user/session information. Useful for testing that credentials are working. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.