# io.github.mongodb-js/mongodb-mcp-server (oci · docker.io/mongodb/mongodb-mcp-server:1.14.0)

MongoDB Model Context Protocol Server

- Trust score: 42/100 (low)
- Change this week: −1
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-04

## Components

- npm · `mongodb-mcp-server`: 43/100, [markdown](https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/mongodb-mcp-server.md), [page](https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/mongodb-mcp-server)
- oci · `docker.io/mongodb/mongodb-mcp-server:1.14.0`: 42/100 (this document), [markdown](https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0.md), [page](https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0)

## Channel facts

- Registry: `oci`
- Package: `docker.io/mongodb/mongodb-mcp-server:1.14.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-04.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 32/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - License check failed: no license is declared.
  - Actively maintained (last published 0 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 82/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 2566 tokens (~95/item across 27 items; 25 tools + 2 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (88% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add mongodb-js-mongodb-mcp-server -- docker run --rm -i docker.io/mongodb/mongodb-mcp-server:1.14.0
```

### Codex

```bash
codex mcp add mongodb-js-mongodb-mcp-server -- docker run --rm -i docker.io/mongodb/mongodb-mcp-server:1.14.0
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mongodb-js-mongodb-mcp-server": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "docker.io/mongodb/mongodb-mcp-server:1.14.0"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  mongodb-js-mongodb-mcp-server:
    command: "docker"
    args: ["run", "--rm", "-i", "docker.io/mongodb/mongodb-mcp-server:1.14.0"]
```

### Other

```json
{
  "mcpServers": {
    "mongodb-js-mongodb-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "docker.io/mongodb/mongodb-mcp-server:1.14.0"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-04 (score 42, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-07-31 (score 38, −5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 43, +35)

- [functional improvement] Schema quality: unverified → 100
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: good
- [functional] First check of Schema quality: pass
- [functional] First check of Tool coverage: 88
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100

### 2026-07-26 (score 8)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (25)

### `aggregate-db` (~131 tokens)

Run an aggregation against a MongoDB database

Input parameters:

- `database` (string, required): Database name
- `pipeline` (array, required): An array of aggregation stages to execute. The first stage must be a database-level aggregation stage (one of `$changeStream`, `$currentOp`, `$documents`, `$listLocalSessions`, `$queryStats`). https:…
- `responseBytesLimit` (number): The maximum number of bytes to return in the response. This value is capped by the server's configured maxBytesPerQuery and cannot be exceeded.

Output parameters:

- `aggResultsCount` (number): The total number of documents returned by the aggregation pipeline
- `appliedLimits` (array): The limits applied to the aggregation pipeline
- `documents` (array): The documents returned by the aggregation pipeline

### `aggregate` (~574 tokens)

Run an aggregation against a MongoDB collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `pipeline` (array, required): An array of aggregation stages to execute. If the user has asked for a vector search, `$vectorSearch` **MUST** be the first stage of the pipeline, or the first stage of a `$unionWith` subpipeline. If…
- `responseBytesLimit` (number): The maximum number of bytes to return in the response. This value is capped by the server's configured maxBytesPerQuery and cannot be exceeded. Note to LLM: If the entire aggregation result is requir…

Output parameters:

- `appliedLimits` (array): The limits applied to the aggregation pipeline
- `count`: The total number of documents returned by the aggregation pipeline
- `documents` (array): The documents returned by the aggregation pipeline

### `collection-indexes` (~34 tokens)

Describe the indexes for a collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name

Output parameters:

- `classicIndexes` (array)
- `classicIndexesCount` (number)
- `searchIndexes` (array)
- `searchIndexesCount` (number)

### `collection-schema` (~86 tokens)

Describe the schema for a collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `responseBytesLimit` (number): The maximum number of bytes to return in the response. This value is capped by the server's configured maxBytesPerQuery and cannot be exceeded.
- `sampleSize` (number): Number of documents to sample for schema inference

Output parameters:

- `fieldsCount` (number)
- `schema` (object)

### `collection-storage-size` (~34 tokens)

Gets the size of the collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name

Output parameters:

- `size` (number)
- `units` (string)

### `connect` (~97 tokens)

Connect to a MongoDB instance. The config resource captures if the server is already connected to a MongoDB cluster. If the user has configured a connection string or has previously called the connect tool, a connection is already established and there's no need to call this tool unless the user has explicitly requested to switch to a new MongoDB cluster.

Input parameters:

- `connectionString` (string, required): MongoDB connection string (in the mongodb:// or mongodb+srv:// format)

Output parameters:

- `connected` (boolean)

### `count` (~80 tokens)

Gets the number of documents in a MongoDB collection using db.collection.count() and query as an optional filter parameter

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `query` (object): A filter/query parameter. Allows users to filter the documents to count. Matches the syntax of the filter argument of db.collection.count().

Output parameters:

- `count` (number): The number of documents in the collection

### `create-collection` (~47 tokens)

Creates a new collection in a database. If the database doesn't exist, it will be created automatically.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name

Output parameters:

- `collection` (string)
- `created` (boolean)
- `database` (string)

### `create-index` (~85 tokens)

Create an index for a collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `definition` (array, required): The index definition. Use 'classic' for standard indexes, 'vectorSearch' for vector search indexes, and 'search' for Atlas Search (lexical) indexes.
- `name` (string): The name of the index

Output parameters:

- `collection` (string)
- `database` (string)
- `indexName` (string)
- `indexType` (string)

### `db-stats` (~30 tokens)

Returns statistics that reflect the use state of a single database

Input parameters:

- `database` (string, required): Database name

Output parameters:

- `stats` (object)

### `delete-many` (~67 tokens)

Removes all documents that match the filter from a MongoDB collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `filter` (object): The query filter, specifying the deletion criteria. Matches the syntax of the filter argument of db.collection.deleteMany()

Output parameters:

- `collection` (string)
- `database` (string)
- `deletedCount` (number)

### `drop-collection` (~48 tokens)

Removes a collection or view from the database. The method also removes any indexes associated with the dropped collection.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name

Output parameters:

- `collection` (string)
- `database` (string)
- `dropped` (boolean)

### `drop-database` (~29 tokens)

Removes the specified database, deleting the associated data files

Input parameters:

- `database` (string, required): Database name

Output parameters:

- `database` (string)
- `dropped` (boolean)

### `drop-index` (~85 tokens)

Drop an index for the provided database and collection.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `indexName` (string, required): The name of the index to be dropped.
- `type` (string, required): The type of index to be deleted. Use 'classic' for standard indexes and 'search' for atlas search and vector search indexes.

Output parameters:

- `collection` (string)
- `database` (string)
- `dropped` (boolean)
- `indexName` (string)

### `explain` (~109 tokens)

Returns statistics describing the execution of the winning plan chosen by the query optimizer for the evaluated method

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `method` (array, required): The method and its arguments to run
- `verbosity` (string): The verbosity of the explain plan, defaults to queryPlanner. If the user wants to know how fast is a query in execution time, use executionStats. It supports all verbosities as defined in the MongoDB…

Output parameters:

- `explainResult` (object)
- `method` (string)
- `verbosity` (string)

### `export` (~162 tokens)

Export a query or aggregation results in the specified EJSON format.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `exportTarget` (array, required): The export target along with its arguments.
- `exportTitle` (string, required): A short description to uniquely identify the export.
- `jsonExportFormat` (string): The format to be used when exporting collection data as EJSON with default being relaxed. relaxed: A string format that emphasizes readability and interoperability at the expense of type preservation…

### `find` (~208 tokens)

Run a find query against a MongoDB collection

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `filter` (object): The query filter, matching the syntax of the query argument of db.collection.find()
- `limit` (number): The maximum number of documents to return
- `projection` (object): The projection, matching the syntax of the projection argument of db.collection.find()
- `responseBytesLimit` (number): The maximum number of bytes to return in the response. This value is capped by the server's configured maxBytesPerQuery and cannot be exceeded. Note to LLM: If the entire query result is required, us…
- `sort` (object): A document, describing the sort order, matching the syntax of the sort argument of cursor.sort(). The keys of the object are the fields to sort on, while the values are the sort directions (1 for asc…

Output parameters:

- `appliedLimits` (array): The limits applied to the find query
- `documents` (array): The documents returned by the find query
- `queryResultsCount` (number): The total number of documents returned by the find query

### `insert-many` (~83 tokens)

Insert an array of documents into a MongoDB collection. If the list of documents is above com.mongodb/maxRequestPayloadBytes, consider inserting them in batches.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `documents` (array, required): The array of documents to insert, matching the syntax of the document argument of db.collection.insertMany().

Output parameters:

- `collection` (string)
- `database` (string)
- `insertedCount` (number)
- `insertedIds` (array)

### `list-collections` (~26 tokens)

List all collections for a given database

Input parameters:

- `database` (string, required): Database name

Output parameters:

- `collections` (array)
- `totalCount` (number)

### `list-databases` (~19 tokens)

List all databases for a MongoDB connection

Output parameters:

- `databases` (array)
- `totalCount` (number)

### `mongodb-logs` (~67 tokens)

Returns the most recent logged mongod events

Input parameters:

- `limit` (integer): The maximum number of log entries to return.
- `type` (string): The type of logs to return. Global returns all recent log entries, while startupWarnings returns only warnings and errors from when the process started.

Output parameters:

- `logs` (array)
- `shownCount` (number)
- `totalLinesWritten` (number)

### `rename-collection` (~69 tokens)

Renames a collection in a MongoDB database

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `dropTarget` (boolean): If true, drops the target collection if it exists
- `newName` (string, required): The new name for the collection

Output parameters:

- `database` (string)
- `newCollection` (string)
- `oldCollection` (string)
- `renamed` (boolean)

### `update-many` (~124 tokens)

Updates 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.

Input parameters:

- `collection` (string, required): Collection name
- `database` (string, required): Database name
- `filter` (object): The selection criteria for the update, matching the syntax of the filter argument of db.collection.updateOne()
- `update` (object, required): An update document describing the modifications to apply using update operator expressions
- `upsert` (boolean): Controls whether to insert a new document if no documents match the filter

Output parameters:

- `collection` (string)
- `database` (string)
- `matchedCount` (number)
- `modifiedCount` (number)
- `upsertedCount` (number)
- `upsertedId` (string)

### `list-knowledge-sources` (~43 tokens)

List available data sources in the MongoDB Assistant knowledge base. Use this to explore available data sources or to find search filter parameters to use in search-knowledge.

### `search-knowledge` (~171 tokens)

Search for information in the MongoDB Assistant knowledge base. This includes official documentation, curated expert guidance, and other resources provided by MongoDB. Supports filtering by data source and version.

Input parameters:

- `dataSources` (array): A list of one or more data sources to limit the search to. You can specify a specific version of a data source by providing the version label. If not provided, the latest version of all data sources…
- `limit` (number): The maximum number of results to return
- `query` (string, required): A natural language query to search for in the MongoDB Assistant knowledge base. This should be a single question or a topic that is relevant to the user's MongoDB use case.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0#diagnostics

## Score history

- 2026-08-04: 42
- 2026-08-03: 38
- 2026-08-02: 38
- 2026-08-01: 38
- 2026-07-31: 38
- 2026-07-30: 43
- 2026-07-29: 43
- 2026-07-28: 43
- 2026-07-27: 43
- 2026-07-26: 8

## Links

- Repository: https://github.com/mongodb-js/mongodb-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0/changelog.json
- HTML version of this page: https://verifymcp.io/servers/mongodb-js-mongodb-mcp-server/docker-io-mongodb-mongodb-mcp-server-1-14-0