Mongo Scout MCP server

Mongo Scout MCP

Scout your MongoDB databases with AI - A production-ready Model Context Protocol server with built-in safety features, live monitoring, and data quality tools.

What You Get

You ask:

"Anything unusual happening with order volume this month?"

Mongo Scout returns:

Volume Analysis: orders

Statistics (last 30 days)

Anomalies Detected

• Feb 14 — 5,892 documents (+7.4σ) — Valentine's Day spike
• Feb 22 — 847 documents (-4.9σ) — Payment gateway outage window
• Mar 1 — 4,201 documents (+3.3σ) — Month-start subscription renewals

Recommendations

• Feb 22 drop warrants investigation — possible data loss during outage
• Consider auto-scaling rules for predictable spikes (month boundaries, holidays)
• Set up alerts for volumes exceeding ±3σ from rolling average

That's detectVolumeAnomalies — one of 50 tools covering exploration, querying, diagnostics, monitoring, data quality, and safe writes.

Quick Start

Claude Code

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

Then ask: "What collections do I have and what do their schemas look like?"

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claudedesktopconfig.json on macOS):

{
  "mcpServers": {
    "mongo-scout": {
      "command": "npx",
      "args": ["-y", "mongo-scout-mcp", "mongodb://localhost:27017", "mydb"],
      "type": "stdio"
    }
  }
}

Cursor / VS Code

Add to your MCP settings:

{
  "mongo-scout": {
    "command": "npx",
    "args": ["-y", "mongo-scout-mcp", "mongodb://localhost:27017", "mydb"]
  }
}

Read-Only vs Read-Write

The server runs in read-only mode by default. For write operations, run a separate instance:

{
  "mcpServers": {
    "mongo-scout-readonly": {
      "command": "npx",
      "args": ["-y", "mongo-scout-mcp", "--read-only", "mongodb://localhost:27017", "mydb"],
      "type": "stdio"
    },
    "mongo-scout-readwrite": {
      "command": "npx",
      "args": ["-y", "mongo-scout-mcp", "--read-write", "mongodb://localhost:27017", "mydb_dev"],
      "type": "stdio"
    }
  }
}

• mongo-scout-readonly: Safe exploration, no risk of data modification
• mongo-scout-readwrite: Write operations when explicitly needed

Tools

Explore — understand your database

• listDatabases — all databases in the instance
• getDatabaseStats — storage and performance statistics
• listCollections — collections in the current database
• getCollectionStats — size, document count, index details
• inferSchema — schema inference from sampled documents

Query — find and analyze documents

• find — query documents with filtering, sorting, projection
• aggregate — run aggregation pipelines
• count — count documents matching a query
• distinct — unique values for a field
• textSearch — full-text search across indexed fields
• explainQuery — query execution plan analysis

Diagnose — spot problems early

• detectVolumeAnomalies — unusual patterns in document volume
• analyzeQueryPerformance — query optimization using explain plans

Monitor — watch it live

Shortened. The full README is on GitHub.