Clutter

by michaelhologram

201 downloads
Not rated
GitHub

About

Synthetic data generator MCP server. Generates realistic companies, documents, and structured data — e.g. to populate SharePoint/test/demo systems. 19 tools, stdio, requires CLUTTER_API_KEY.

Details

Author
michaelhologram
Downloads
201
Categories
Developer Tools

- Generates realistic companies, documents, and structured data
- Provides 19 distinct tools for synthetic data creation
- Runs over the stdio transport protocol
- Requires an API key for authentication

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Clutter
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

clutter_whoami

Return the authenticated Clutter user for the configured API key.

get_usage

Your Clutter API usage (request counts by route) over a rolling window + the daily quota.

list_projects

List all of your Clutter projects (top-level tenant containers).

create_project

Create a new Clutter project. Returns the project (with its id).

delete_project

Delete a project and EVERYTHING under it — all its organisations, runs, datasets, metadata and artefacts (S3 + DB). Irreversible.

list_orgs

List the synthetic organisations in a project.

build_org

Start building a synthetic organisation from a prompt. Returns 202 with an orgId. The build runs in the background (minutes) — then poll get_org, or call wait_for_org to block until ready. Omit projectId to auto-create a project (named after the generated company) — the simplest path.

get_org

Get an organisation including its full org.json structure. Check `org.status`.

wait_for_org

Poll an org until its build reaches a terminal state (ready/failed) or the timeout. Returns the final org summary.

query_org

Ask a grounded natural-language question about an organisation (synchronous, one-shot answer).

delete_org

Delete an organisation and ALL its runs/artefacts (S3 + DB). Irreversible.

list_runs

List the generation runs under an organisation.

create_run

Launch a generation run. Returns 202 with a runId — poll get_run or call wait_for_run. kind + params: • doc_generator → { prompt, doc_number (≤300), file_types:[docx|pdf|xlsx|eml|jpg], structure:'flat'|'nested', target_system?, allow_underscores? } • data_generator → { prompt, row_count (≤2000), data_format:'xlsx'|'csv'|'json', data_fields?, target_system? } • doc_metadata_gen → { sourceRunId (a completed doc_generator run), data_format, data_fields?, target_system? }

get_run

Get a run's status + progress counts. Poll this until status is terminal.

wait_for_run

Poll a run until it reaches a terminal state (complete/partial/failed) or the timeout. Returns the final run status.

list_run_documents

List the documents generated by a run (title, format, folderPath, status).

get_document_url

Get a short-lived presigned download URL for a single generated document.

build_zip

Start building a single ZIP of all of a run's documents. Poll get_zip_url after.

get_zip_url

Get a presigned download URL for a run's ZIP (409 until the build is ready).

delete_run

Delete a run and its artefacts (S3 + DB). Leaves the parent org intact. Irreversible.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "clutter": {
            "clutter": {
                "command": "npx",
                "args": [
                    "-y",
                    "clutter-mcp"
                ],
                "env": {
                    "CLUTTER_API_KEY": "<YOUR_CLUTTER_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "clutter": {
        "command": "npx",
        "args": [
            "-y",
            "clutter-mcp"
        ],
        "env": {
            "CLUTTER_API_KEY": "<YOUR_CLUTTER_API_KEY>"
        }
    }
}

Synthetic data generator MCP server. Generates realistic companies, documents, and structured data — e.g. to populate SharePoint/test/demo systems. 19 tools, stdio, requires CLUTTER_API_KEY.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.