Omniscient Master Suite OMNISCIENT · 3.1

Flickr Uploader v1.0.0

Social & publishing flickr-uploader 3 actions MCP Custom UI

The full drip-feed Flickr uploader: per-folder upload premises with an interval scheduler, initial delay, random order and filename modification, a template manager, a full-setup manager, and threaded batch uploads with live byte/bitrate progress. Flickr API key/secret and OAuth token live in the vault, never in code or on disk in plaintext. Headless actions upload one file, upload a whole folder, or check the stored login.

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

Upload one file

upload_image Destructive

Upload a single photo or video to Flickr with a title and description.

Inputs

NameTypeRequired / defaultValues and notes
file path required
title string optional, default ""
description text optional, default ""
profile profile optional, default flickr

Outputs

NameTypeNotes
file path
photo_id string

Upload a folder

upload_folder Destructive

Upload every supported photo/video in a folder to Flickr, skipping files already marked uploaded (the same '_flickr.txt' marker the drip-feed scheduler uses), with a shared title pattern and description.

Inputs

NameTypeRequired / defaultValues and notes
folder path required
title string optional, default ""
description text optional, default ""
skip_posted bool optional, default true
profile profile optional, default flickr

Outputs

NameTypeNotes
count int
failed int

Check Flickr login

check_login

Verify the vault-stored Flickr credentials work by calling flickr.test.login, without uploading anything.

Inputs

NameTypeRequired / defaultValues and notes
profile profile optional, default flickr

Outputs

NameTypeNotes
ok bool
user_id string
username string

Use it

Upload one file

Command line

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

# preview first - destructive action, nothing is changed:
python app.py --action upload_image --params '{"file": "D:/path/to/file"}' --dry-run

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("flickr-uploader", "upload_image", {"file": "D:/path/to/file"})

# preview first:
run_action("flickr-uploader", "upload_image", {"file": "D:/path/to/file"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "flickr-uploader",
  "action": "upload_image",
  "params": {
    "file": "D:/path/to/file"
  },
  "inputs": {}
}

Upload a folder

Command line

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

# preview first - destructive action, nothing is changed:
python app.py --action upload_folder --params '{"folder": "D:/path/to/folder"}' --dry-run

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("flickr-uploader", "upload_folder", {"folder": "D:/path/to/folder"})

# preview first:
run_action("flickr-uploader", "upload_folder", {"folder": "D:/path/to/folder"}, dry_run=true)

Workflow node

json
{
  "id": "n0",
  "app": "flickr-uploader",
  "action": "upload_folder",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Check Flickr login

Command line

shell
python app.py --action check_login --params '{}'

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("flickr-uploader", "check_login", {})

Workflow node

json
{
  "id": "n0",
  "app": "flickr-uploader",
  "action": "check_login",
  "params": {},
  "inputs": {}
}

Example prompts

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