mongodb-mcp-server

MongoDB Model Context Protocol Server

stdioofficialapplication

Package Details

mongodb-mcp-server

1.11.0•https://www.npmjs.com/package/mongodb-mcp-server

Transportstdio

Package Arguments

Named

--allowRequestOverrides

When set to true, allows configuration values to be overridden via request headers and query parameters.

--apiClientId

Atlas API client ID for authentication. Required for running Atlas tools.

--apiClientSecret

Atlas API client secret for authentication. Required for running Atlas tools.

--assistantBaseUrl

Base URL for the MongoDB Assistant API.

--atlasTemporaryDatabaseUserLifetimeMs

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

--confirmationRequiredTools

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

--connectionString

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

--disabledTools

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

--dryRun

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

--exportCleanupIntervalMs

Time in milliseconds between export cleanup cycles that remove expired export files.

--exportTimeoutMs

Time in milliseconds after which an export is considered expired and eligible for cleanup.

--exportsPath

Folder to store exported data files.

--externallyManagedSessions

When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.

--healthCheckHost

Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.

--healthCheckPort

Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.

--httpBodyLimit

Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.

--httpHeaders

Header that the HTTP server will validate when making requests (only used when transport is 'http').

--httpHost

Host address to bind the HTTP server to (only used when transport is 'http').

--httpPort

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

--httpResponseType

The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.

--idleTimeoutMs

Idle timeout for a client to disconnect (only applies to http transport).

--indexCheck

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

--logPath

Folder to store logs.

--loggers

Comma separated values of logger types.

--maxBytesPerQuery

The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.

--maxDocumentsPerQuery

The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.

--maxTimeMS

The maximum time in milliseconds that operations are allowed to run on the MongoDB server. When set, this value is passed as the maxTimeMS option to read operations such as find, aggregate, and count.

--mcpClientLogLevel

Minimum severity level for log messages forwarded to the MCP client.

--monitoringServerFeatures

Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).

--monitoringServerHost

Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.

--monitoringServerPort

Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.

--notificationTimeoutMs

Notification timeout for a client to be aware of disconnect (only applies to http transport).

--previewFeatures

Comma separated values of preview features that are enabled.

--readOnly

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

--telemetry

When set to disabled, disables telemetry collection.

--transport

Either 'stdio' or 'http'.

--voyageApiKey

API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

Environment Variables

MDB_MCP_ALLOW_REQUEST_OVERRIDES(bool)

When set to true, allows configuration values to be overridden via request headers and query parameters.

MDB_MCP_API_CLIENT_ID(str)

Secret

Atlas API client ID for authentication. Required for running Atlas tools.

MDB_MCP_API_CLIENT_SECRET(str)

Secret

Atlas API client secret for authentication. Required for running Atlas tools.

MDB_MCP_ASSISTANT_BASE_URL(str)

Base URL for the MongoDB Assistant API.

MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS(num)

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

MDB_MCP_CONFIRMATION_REQUIRED_TOOLS(str)

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

MDB_MCP_CONNECTION_STRING(str)

Secret

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

MDB_MCP_DISABLED_TOOLS(str)

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

MDB_MCP_DRY_RUN(bool)

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS(num)

Time in milliseconds between export cleanup cycles that remove expired export files.

MDB_MCP_EXPORT_TIMEOUT_MS(num)

Time in milliseconds after which an export is considered expired and eligible for cleanup.

MDB_MCP_EXPORTS_PATH(str)

Folder to store exported data files.

MDB_MCP_EXTERNALLY_MANAGED_SESSIONS(bool)

When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.

MDB_MCP_HEALTH_CHECK_HOST(str)

Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.

MDB_MCP_HEALTH_CHECK_PORT(num)

Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.

MDB_MCP_HTTP_BODY_LIMIT(num)

Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.

MDB_MCP_HTTP_HEADERS(str)

Header that the HTTP server will validate when making requests (only used when transport is 'http').

MDB_MCP_HTTP_HOST(str)

Host address to bind the HTTP server to (only used when transport is 'http').

MDB_MCP_HTTP_PORT(num)

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

MDB_MCP_HTTP_RESPONSE_TYPE(str)

The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.

MDB_MCP_IDLE_TIMEOUT_MS(num)

Idle timeout for a client to disconnect (only applies to http transport).

MDB_MCP_INDEX_CHECK(bool)

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

MDB_MCP_LOG_PATH(str)

Folder to store logs.

MDB_MCP_LOGGERS(str)

Comma separated values of logger types.

MDB_MCP_MAX_BYTES_PER_QUERY(num)

The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.

MDB_MCP_MAX_DOCUMENTS_PER_QUERY(num)

The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.

MDB_MCP_MAX_TIME_M_S(num)

MDB_MCP_MCP_CLIENT_LOG_LEVEL(str)

Minimum severity level for log messages forwarded to the MCP client.

MDB_MCP_MONITORING_SERVER_FEATURES(str)

Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).

MDB_MCP_MONITORING_SERVER_HOST(str)

Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.

MDB_MCP_MONITORING_SERVER_PORT(num)

Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.

MDB_MCP_NOTIFICATION_TIMEOUT_MS(num)

Notification timeout for a client to be aware of disconnect (only applies to http transport).

MDB_MCP_PREVIEW_FEATURES(str)

Comma separated values of preview features that are enabled.

MDB_MCP_READ_ONLY(bool)

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

MDB_MCP_TELEMETRY(str)

When set to disabled, disables telemetry collection.

MDB_MCP_TRANSPORT(str)

Either 'stdio' or 'http'.

MDB_MCP_VOYAGE_API_KEY(str)

Secret

API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

docker.io/mongodb/mongodb-mcp-server:1.11.0

https://hub.docker.com/r/mongodb/mongodb-mcp-server

Transportstdio

Package Arguments

Named

--allowRequestOverrides

When set to true, allows configuration values to be overridden via request headers and query parameters.

--apiClientId

Atlas API client ID for authentication. Required for running Atlas tools.

--apiClientSecret

Atlas API client secret for authentication. Required for running Atlas tools.

--assistantBaseUrl

Base URL for the MongoDB Assistant API.

--atlasTemporaryDatabaseUserLifetimeMs

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

--confirmationRequiredTools

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

--connectionString

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

--disabledTools

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

--dryRun

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

--exportCleanupIntervalMs

Time in milliseconds between export cleanup cycles that remove expired export files.

--exportTimeoutMs

Time in milliseconds after which an export is considered expired and eligible for cleanup.

--exportsPath

Folder to store exported data files.

--externallyManagedSessions

When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.

--healthCheckHost

Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.

--healthCheckPort

Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.

--httpBodyLimit

Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.

--httpHeaders

Header that the HTTP server will validate when making requests (only used when transport is 'http').

--httpHost

Host address to bind the HTTP server to (only used when transport is 'http').

--httpPort

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

--httpResponseType

The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.

--idleTimeoutMs

Idle timeout for a client to disconnect (only applies to http transport).

--indexCheck

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

--logPath

Folder to store logs.

--loggers

Comma separated values of logger types.

--maxBytesPerQuery

The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.

--maxDocumentsPerQuery

The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.

--maxTimeMS

--mcpClientLogLevel

Minimum severity level for log messages forwarded to the MCP client.

--monitoringServerFeatures

Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).

--monitoringServerHost

Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.

--monitoringServerPort

Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.

--notificationTimeoutMs

Notification timeout for a client to be aware of disconnect (only applies to http transport).

--previewFeatures

Comma separated values of preview features that are enabled.

--readOnly

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

--telemetry

When set to disabled, disables telemetry collection.

--transport

Either 'stdio' or 'http'.

--voyageApiKey

API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).

Environment Variables

MDB_MCP_ALLOW_REQUEST_OVERRIDES(bool)

When set to true, allows configuration values to be overridden via request headers and query parameters.

MDB_MCP_API_CLIENT_ID(str)

Secret

Atlas API client ID for authentication. Required for running Atlas tools.

MDB_MCP_API_CLIENT_SECRET(str)

Secret

Atlas API client secret for authentication. Required for running Atlas tools.

MDB_MCP_ASSISTANT_BASE_URL(str)

Base URL for the MongoDB Assistant API.

MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS(num)

Time in milliseconds that temporary database users created when connecting to MongoDB Atlas clusters will remain active before being automatically deleted.

MDB_MCP_CONFIRMATION_REQUIRED_TOOLS(str)

Comma separated values of tool names that require user confirmation before execution. Requires the client to support elicitation.

MDB_MCP_CONNECTION_STRING(str)

Secret

MongoDB connection string for direct database connections. Optional, if not set, you'll need to call the connect tool before interacting with MongoDB data.

MDB_MCP_DISABLED_TOOLS(str)

Comma separated values of tool names, operation types, and/or categories of tools that will be disabled.

MDB_MCP_DRY_RUN(bool)

When true, runs the server in dry mode: dumps configuration and enabled tools, then exits without starting the server.

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS(num)

Time in milliseconds between export cleanup cycles that remove expired export files.

MDB_MCP_EXPORT_TIMEOUT_MS(num)

Time in milliseconds after which an export is considered expired and eligible for cleanup.

MDB_MCP_EXPORTS_PATH(str)

Folder to store exported data files.

MDB_MCP_EXTERNALLY_MANAGED_SESSIONS(bool)

When true, the HTTP transport allows requests with a session ID supplied externally through the 'mcp-session-id' header. When an external ID is supplied, the initialization request is optional.

MDB_MCP_HEALTH_CHECK_HOST(str)

Deprecated. Use `monitoringServerHost` instead. Host address to bind the healthCheck HTTP server to (only used when transport is 'http'). If provided, `healthCheckPort` must also be set.

MDB_MCP_HEALTH_CHECK_PORT(num)

Deprecated. Use `monitoringServerPort` instead. Port number for the healthCheck HTTP server (only used when transport is 'http'). If provided, `healthCheckHost` must also be set.

MDB_MCP_HTTP_BODY_LIMIT(num)

Maximum size of the HTTP request body in bytes (only used when transport is 'http'). This value is passed as the optional limit parameter to the Express.js json() middleware.

MDB_MCP_HTTP_HEADERS(str)

Header that the HTTP server will validate when making requests (only used when transport is 'http').

MDB_MCP_HTTP_HOST(str)

Host address to bind the HTTP server to (only used when transport is 'http').

MDB_MCP_HTTP_PORT(num)

Port number for the HTTP server (only used when transport is 'http'). Use 0 for a random port.

MDB_MCP_HTTP_RESPONSE_TYPE(str)

The HTTP response type for tool responses: 'sse' for Server-Sent Events, 'json' for standard JSON responses.

MDB_MCP_IDLE_TIMEOUT_MS(num)

Idle timeout for a client to disconnect (only applies to http transport).

MDB_MCP_INDEX_CHECK(bool)

When set to true, enforces that query operations must use an index, rejecting queries that perform a collection scan.

MDB_MCP_LOG_PATH(str)

Folder to store logs.

MDB_MCP_LOGGERS(str)

Comma separated values of logger types.

MDB_MCP_MAX_BYTES_PER_QUERY(num)

The maximum size in bytes for results from a find or aggregate tool call. This serves as an upper bound for the responseBytesLimit parameter in those tools.

MDB_MCP_MAX_DOCUMENTS_PER_QUERY(num)

The maximum number of documents that can be returned by a find or aggregate tool call. For the find tool, the effective limit will be the smaller of this value and the tool's limit parameter.

MDB_MCP_MAX_TIME_M_S(num)

MDB_MCP_MCP_CLIENT_LOG_LEVEL(str)

Minimum severity level for log messages forwarded to the MCP client.

MDB_MCP_MONITORING_SERVER_FEATURES(str)

Features to expose on the monitoring server (only used when transport is 'http' and monitoringServerHost/monitoringServerPort are set).

MDB_MCP_MONITORING_SERVER_HOST(str)

Host address to bind the monitoring HTTP server to (only used when transport is 'http'). If provided, `monitoringServerPort` must also be set.

MDB_MCP_MONITORING_SERVER_PORT(num)

Port number for the monitoring HTTP server (only used when transport is 'http'). If provided, `monitoringServerHost` must also be set.

MDB_MCP_NOTIFICATION_TIMEOUT_MS(num)

Notification timeout for a client to be aware of disconnect (only applies to http transport).

MDB_MCP_PREVIEW_FEATURES(str)

Comma separated values of preview features that are enabled.

MDB_MCP_READ_ONLY(bool)

When set to true, only allows read, connect, and metadata operation types, disabling create/update/delete operations.

MDB_MCP_TELEMETRY(str)

When set to disabled, disables telemetry collection.

MDB_MCP_TRANSPORT(str)

Either 'stdio' or 'http'.

MDB_MCP_VOYAGE_API_KEY(str)

Secret

API key for Voyage AI embeddings service (required for creating Atlas Local deployments with auto-embed vector search capabilities).