sample_data

Extract random document samples from MongoDB collections for analysis or testing. Supports JSON and CSV formats to facilitate exploratory data analysis, performance testing, and data distribution insights.

Instructions

Get a random sample of documents from a collection.

Supports both JSON and CSV output formats:

Use outputFormat="json" for standard JSON (default)
Use outputFormat="csv" for comma-separated values export

Useful for:

Exploratory data analysis
Testing with representative data
Understanding data distribution
Performance testing with realistic data subsets

Example - JSON Sample: use_mcp_tool with server_name: "mongodb", tool_name: "sample_data", arguments: { "collection": "users", "size": 50 }

Example - CSV Export: use_mcp_tool with server_name: "mongodb", tool_name: "sample_data", arguments: { "collection": "users", "size": 100, "outputFormat": "csv", "formatOptions": { "includeHeaders": true, "delimiter": "," } }

Input Schema

Name	Required	Description
`collection`	Yes	Collection name
`database`	No	Database name (optional if default database is configured)
`formatOptions`	No	Format-specific options
`outputFormat`	No	Output format for results (json or csv)
`size`	No	Number of random documents to sample (default: 10)

Input Schema (JSON Schema)

{
  "properties": {
    "collection": {
      "description": "Collection name",
      "type": "string"
    },
    "database": {
      "description": "Database name (optional if default database is configured)",
      "type": "string"
    },
    "formatOptions": {
      "description": "Format-specific options",
      "properties": {
        "delimiter": {
          "description": "CSV delimiter character (default: comma)",
          "type": "string"
        },
        "includeHeaders": {
          "description": "Whether to include header row in CSV (default: true)",
          "type": "boolean"
        }
      },
      "type": "object"
    },
    "outputFormat": {
      "description": "Output format for results (json or csv)",
      "enum": [
        "json",
        "csv"
      ],
      "type": "string"
    },
    "size": {
      "description": "Number of random documents to sample (default: 10)",
      "maximum": 1000,
      "minimum": 1,
      "type": "number"
    }
  },
  "required": [
    "collection"
  ],
  "type": "object"
}

MongoDB MCP Server

sample_data

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from MongoDB MCP Server

Related Tools