Omniscient Master Suite OMNISCIENT · 3.1

Chat Analysis v1.0.0

Data & charts chatgpt-analysis 2 actions MCP

Analyse an exported ChatGPT/LLM conversation JSON: message counts per role, conversation-length stats, word-frequency top terms, and an optional wordcloud image.

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: analysewordcloud

Analyse export

analyse

Compute message counts per role, conversation-length stats and word-frequency top terms for an exported ChatGPT/LLM conversation JSON, saved as a sidecar report.

Inputs

NameTypeRequired / defaultValues and notes
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

NameTypeNotes
stats json
file path

Render wordcloud

wordcloud

Render a wordcloud image from the conversation's word frequencies. Falls back to writing the word frequencies as JSON if the optional wordcloud/matplotlib packages are not installed.

Inputs

NameTypeRequired / defaultValues and notes
file path required
max_words int optional, default 200
min_word_len int optional, default 3
width int optional, default 1600
height int optional, default 900
background_color string optional, default white
out path optional, default ""

Outputs

NameTypeNotes
file path
format string

Use it

Analyse export

Command line

shell
python app.py --action analyse --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("chatgpt-analysis", "analyse", {"file": "D:/path/to/file"})

Workflow node

json
{
  "id": "n0",
  "app": "chatgpt-analysis",
  "action": "analyse",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Render wordcloud

Command line

shell
python app.py --action wordcloud --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("chatgpt-analysis", "wordcloud", {"file": "D:/path/to/file"})

Workflow node

json
{
  "id": "n0",
  "app": "chatgpt-analysis",
  "action": "wordcloud",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Example prompts

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