JSON Toolkit v1.0.0

Data & charts json-toolkit 4 actions MCP

Analyse, clean and flatten JSON files: word-frequency and structure stats, a normalised copy, or a human-readable text outline, for one file or a whole folder.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: statscleanto_textbatch_stats

Analyze a file

stats

Compute structure and word-frequency statistics for a JSON file, with a heuristic topic guess, saved as a sidecar report.

Inputs

Name	Type	Required / default
`file`	path	required
`top_n`	int	optional, default `25`
`min_word_len`	int	optional, default `3`
`save`	bool	optional, default `true`
`out`	path	optional, default `""`

Outputs

Name	Type	Notes
`stats`	json
`file`	path

Clean a file

clean

Write a normalised copy of a JSON file: keys sorted, strings trimmed, and empty values or duplicate list items optionally pruned.

Inputs

Name	Type	Required / default
`file`	path	required
`sort_keys`	bool	optional, default `true`
`trim_strings`	bool	optional, default `true`
`drop_empty`	bool	optional, default `false`
`dedupe_lists`	bool	optional, default `false`
`indent`	int	optional, default `2`
`out`	path	optional, default `""`

Outputs

Name	Type	Notes
`file`	path
`changed`	bool

Flatten to text

to_text

Render a JSON file as an indented, human-readable text outline (or flat path=value lines) and save it alongside the source.

Inputs

Name	Type	Required / default	Values and notes
`file`	path	required
`style`	enum	optional, default `outline`	`outlinelines`
`save`	bool	optional, default `true`
`out`	path	optional, default `""`

Outputs

Name	Type	Notes
`text`	text
`file`	path

Analyze a folder

batch_stats

Run the same word-frequency and structure analysis on every JSON file in a folder, writing a sidecar report per file.

Inputs

Name	Type	Required / default
`folder`	path	required
`recursive`	bool	optional, default `false`
`top_n`	int	optional, default `25`
`min_word_len`	int	optional, default `3`

Outputs

Name	Type	Notes
`count`	int
`files`	path[]

Use it

Analyze a file

Command line

shell

python app.py --action stats --params '{"file": "D:/path/to/file"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("json-toolkit", "stats", {"file": "D:/path/to/file"})

Workflow node

json

{
  "id": "n0",
  "app": "json-toolkit",
  "action": "stats",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Clean a file

Command line

shell

python app.py --action clean --params '{"file": "D:/path/to/file"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("json-toolkit", "clean", {"file": "D:/path/to/file"})

Workflow node

json

{
  "id": "n0",
  "app": "json-toolkit",
  "action": "clean",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Flatten to text

Command line

shell

python app.py --action to_text --params '{"file": "D:/path/to/file"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("json-toolkit", "to_text", {"file": "D:/path/to/file"})

Workflow node

json

{
  "id": "n0",
  "app": "json-toolkit",
  "action": "to_text",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Analyze a folder

Command line

shell

python app.py --action batch_stats --params '{"folder": "D:/path/to/folder"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("json-toolkit", "batch_stats", {"folder": "D:/path/to/folder"})

Workflow node

json

{
  "id": "n0",
  "app": "json-toolkit",
  "action": "batch_stats",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.

give me word-frequency stats for data.json
clean up config.json - sort keys and drop empty fields
flatten report.json into a readable text outline
analyze every JSON file in D:/exports for word frequency