Log inSubmit server
Mongo Scout MCP logo

Mongo Scout MCP

Connects AI agents to MongoDB for exploration, querying, monitoring, data quality checks, and controlled administration.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install Mongo Scout MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mongo-scout-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mongo-scout-mcp"
      ],
      "env": {
        "ENABLE_LOGGING": "YOUR_VALUE_HERE",
        "LOG_DIR": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

The mongo-scout-mcp MCP server connects AI agents to MongoDB through tools for database exploration, document queries, diagnostics, monitoring, and data quality analysis. It runs over stdio with a MongoDB connection string and database supplied as command-line arguments, and uses read-only mode by default. Reach for it when you need conversational access to schemas, query plans, live server metrics, anomalies, relationships, or controlled database operations. Read-write mode adds guarded modification tools, previews, limits, and index or collection management.

Use cases

  • Explore MongoDB collections and inferred schemas
  • Analyze query plans and slow operations
  • Detect unusual document-volume patterns
  • Check collections for data-quality problems
  • Monitor live MongoDB server activity

Key features

  • Read-only MongoDB access by default
  • Schema inference and document querying
  • Query performance and volume anomaly analysis
  • Live server and collection monitoring
  • Data-quality and relationship checks
  • Previewed and controlled write operations

Tools40

What Mongo Scout MCP lets your agent do. Expand a tool for its parameters.

Self-reported~460 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 15d ago via OSV.dev · mongo-scout-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads204Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Tools exposed40Callable tools this server registers over MCP.

How Mongo Scout MCP works

What mongo-scout-mcp does

The mongo-scout-mcp MCP server gives an MCP client an AI-accessible interface to a MongoDB instance and a selected database. Its read-only tools cover database and collection discovery, sampled schema inference, filtered document queries, aggregation pipelines, counts, distinct values, indexed text search, and query-plan inspection.

It also supports operational investigation. Agents can inspect server status, active operations, connection-pool health, profiler data, live metrics, busy collections, collection-level metrics, and slow operations. Data-quality tools look for duplicate records, missing fields, inconsistent types, and orphaned references. Relationship traversal and time-window queries help investigate connected or historical data.

How it works

Start the process with a MongoDB URI and database name. The MCP client launches the package as a stdio process, then exposes the server's functions to the connected model. For example, an agent can combine listCollections with inferSchema, or use getServerStatus, getCurrentOperations, and getHottestCollections to inspect current activity.

Volume analysis can group timestamped records and identify unusual document counts over a lookback period. Query performance analysis uses explain plans, while findOrphans compares references between collections. MongoDB ObjectId values may be supplied either as an extended JSON object with $oid or as a hexadecimal string.

Setup and configuration

Install and launch it with npx:

Terminal
claude mcp add mongo-scout -- npx -y mongo-scout-mcp mongodb://localhost:27017 mydb

The same command can be placed in Claude Desktop, Cursor, or VS Code MCP configuration as a stdio server. Replace the URI and database with the target environment. The default mode is read-only. Use --read-write for a separate instance when modifications are required; --mode <mode> is also available, and --read-only explicitly selects the default safety posture.

File logging is off by default. Set ENABLE_LOGGING=true to enable it and use LOG_DIR to choose the log directory; the default is ./logs. Usage and error logs redact connection strings.

Tools and capabilities

The mongo-scout-mcp MCP server includes tools for:

  • Discovering databases, collections, indexes, collection statistics, and inferred schemas.
  • Finding, aggregating, counting, searching, and inspecting documents and execution plans.
  • Detecting volume anomalies and analyzing query performance.
  • Monitoring server status, current operations, pools, profiler output, live metrics, hot collections, and slow operations.
  • Checking duplicates, orphaned references, missing fields, inconsistent types, and custom $expr validations.
  • Traversing relationships and querying recent or date-range data.
  • Exporting or cloning collections, including JSON, JSONL, and CSV export options.
  • Previewing updates, deletes, and bulk writes before applying them.
  • In read-write mode, inserting, updating, replacing, deleting, bulk-writing, renaming fields, and creating or dropping collections and indexes.

Limitations and notes

Write operations are not available in the default read-only mode. runAdminCommand can execute administrative commands, so access should be configured against an appropriate MongoDB account and environment.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Mongo Scout MCP

mongo-scout-mcp is an MCP server that connects AI agents to MongoDB databases for exploration, querying, monitoring, and data-quality analysis. Its main tools list databases and collections, infer schemas, find or aggregate documents, inspect query plans, detect volume anomalies, monitor server activity, and check duplicates, orphans, missing fields, and inconsistent types.

Install it through npx by launching `npx -y mongo-scout-mcp` with a MongoDB URI and database name. For Claude Code, use `claude mcp add mongo-scout -- npx -y mongo-scout-mcp mongodb://localhost:27017 mydb`; Claude Desktop, Cursor, and VS Code use equivalent stdio configuration.

Yes, mongo-scout-mcp starts in read-only mode by default. Use `--read-write` or an appropriate `--mode` value to enable modification tools, and run a separate instance when you need writes. Preview tools can show the expected changes before updates, deletes, or bulk writes.

Yes, mongo-scout-mcp works with Cursor through its MCP settings as a stdio server. Configure the command as `npx` with arguments for `-y`, `mongo-scout-mcp`, the MongoDB connection string, and the target database.

Enable logging by setting `ENABLE_LOGGING=true`. Logs are written to `./logs` by default, or to the directory specified by `LOG_DIR`; the server creates tool-usage and error log files and redacts connection strings in output.

Related MCP servers

All in Databases All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMongo Scout MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mongo-scout-mcp?style=directory)](https://allmcps.com/mcp/mongo-scout-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/mongo-scout-mcp"><img src="https://allmcps.com/api/badge/mongo-scout-mcp?style=directory" alt="Mongo Scout MCP on AllMCPs" /></a>