MCP ServerSTDIOOfficialv1.9.0

mongodb-mcp-server MCP Server

MongoDB Model Context Protocol Server

io.github.mongodb-js/mongodb-mcp-server

Hosted URL

https://github.com/mongodb-js/mongodb-mcp-server

Transport

STDIO

Auth

No auth required

Connect to mongodb-mcp-server

Hosted endpoint — paste into any MCP client.

https://github.com/mongodb-js/mongodb-mcp-server

Environment variables

Configuration this server reads at startup.

  • MDB_MCP_ALLOW_REQUEST_OVERRIDES

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

  • MDB_MCP_API_CLIENT_IDSecret

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

  • MDB_MCP_API_CLIENT_SECRETSecret

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

  • MDB_MCP_ASSISTANT_BASE_URL

    Base URL for the MongoDB Assistant API.

  • MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS

    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

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

  • MDB_MCP_CONNECTION_STRINGSecret

    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

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

  • MDB_MCP_DRY_RUN

    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

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

  • MDB_MCP_EXPORT_TIMEOUT_MS

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

  • MDB_MCP_EXPORTS_PATH

    Folder to store exported data files.

  • MDB_MCP_EXTERNALLY_MANAGED_SESSIONS

    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

    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

    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

    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

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

  • MDB_MCP_HTTP_HOST

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

  • MDB_MCP_HTTP_PORT

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

  • MDB_MCP_HTTP_RESPONSE_TYPE

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

  • MDB_MCP_IDLE_TIMEOUT_MS

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

  • MDB_MCP_INDEX_CHECK

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

  • MDB_MCP_LOG_PATH

    Folder to store logs.

  • MDB_MCP_LOGGERS

    Comma separated values of logger types.

  • MDB_MCP_MAX_BYTES_PER_QUERY

    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

    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_MONITORING_SERVER_FEATURES

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

  • MDB_MCP_MONITORING_SERVER_HOST

    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

    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

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

  • MDB_MCP_PREVIEW_FEATURES

    Comma separated values of preview features that are enabled.

  • MDB_MCP_READ_ONLY

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

  • MDB_MCP_TELEMETRY

    When set to disabled, disables telemetry collection.

  • MDB_MCP_TRANSPORT

    Either 'stdio' or 'http'.

  • MDB_MCP_VOYAGE_API_KEYSecret

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

  • MDB_MCP_ALLOW_REQUEST_OVERRIDES

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

  • MDB_MCP_API_CLIENT_IDSecret

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

  • MDB_MCP_API_CLIENT_SECRETSecret

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

  • MDB_MCP_ASSISTANT_BASE_URL

    Base URL for the MongoDB Assistant API.

  • MDB_MCP_ATLAS_TEMPORARY_DATABASE_USER_LIFETIME_MS

    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

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

  • MDB_MCP_CONNECTION_STRINGSecret

    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

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

  • MDB_MCP_DRY_RUN

    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

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

  • MDB_MCP_EXPORT_TIMEOUT_MS

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

  • MDB_MCP_EXPORTS_PATH

    Folder to store exported data files.

  • MDB_MCP_EXTERNALLY_MANAGED_SESSIONS

    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

    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

    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

    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

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

  • MDB_MCP_HTTP_HOST

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

  • MDB_MCP_HTTP_PORT

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

  • MDB_MCP_HTTP_RESPONSE_TYPE

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

  • MDB_MCP_IDLE_TIMEOUT_MS

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

  • MDB_MCP_INDEX_CHECK

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

  • MDB_MCP_LOG_PATH

    Folder to store logs.

  • MDB_MCP_LOGGERS

    Comma separated values of logger types.

  • MDB_MCP_MAX_BYTES_PER_QUERY

    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

    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_MONITORING_SERVER_FEATURES

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

  • MDB_MCP_MONITORING_SERVER_HOST

    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

    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

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

  • MDB_MCP_PREVIEW_FEATURES

    Comma separated values of preview features that are enabled.

  • MDB_MCP_READ_ONLY

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

  • MDB_MCP_TELEMETRY

    When set to disabled, disables telemetry collection.

  • MDB_MCP_TRANSPORT

    Either 'stdio' or 'http'.

  • MDB_MCP_VOYAGE_API_KEYSecret

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

Resources

Where to find authoritative docs and source for mongodb-mcp-server.

Try mongodb-mcp-server with 30+ AI models

Open MCP Agent Studio and connect this server to Claude, GPT, Gemini, DeepSeek and more — no install required.

Open Agent Studio

Related servers

More on MCP Playground