Colour Palette v1.0.0

Images colorpalette 2 actions MCP

Extract the dominant colour palette from an image or a whole folder of images, as hex codes plus an optional swatch PNG and JSON sidecar.

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

extract

Extract the dominant colours from one image as hex codes, optionally writing a swatch PNG and/or a JSON sidecar.

Name	Type	Required / default
`image`	path	required
`colors`	int	optional, default `6`
`swatch`	bool	optional, default `true`
`json`	bool	optional, default `false`
`out`	path	optional, default `""`

extract_folder

Extract a dominant colour palette for every image in a folder, writing a palette.png per image plus one combined JSON index.

Name	Type	Required / default
`folder`	path	required
`colors`	int	optional, default `6`
`swatch`	bool	optional, default `true`
`json`	bool	optional, default `false`
`recursive`	bool	optional, default `false`
`out`	path	optional, default `""`

shell

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

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

run_action("colorpalette", "extract", {"image": "D:/path/to/image"})

json

{
  "id": "n0",
  "app": "colorpalette",
  "action": "extract",
  "params": {
    "image": "D:/path/to/image"
  },
  "inputs": {}
}

shell

python app.py --action extract_folder --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

run_action("colorpalette", "extract_folder", {"folder": "D:/path/to/folder"})

json

{
  "id": "n0",
  "app": "colorpalette",
  "action": "extract_folder",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

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