Upload photos and video to Shutterstock Contributor over its FTPS drop, with optional description/keywords delivered as a matching metadata sheet, using vault-stored credentials.
The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.
Jump to:
check_authuploadupload_folder
check_auth
Log in to the Shutterstock Contributor FTPS drop and straight back out, to verify the stored credentials work without uploading anything.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
profile |
profile |
optional, default shutterstock
|
| Name | Type | Notes |
|---|---|---|
ok |
bool | |
host |
string | |
username |
string |
upload
Destructive
Upload a single photo or video to Shutterstock. An optional description/keywords pair is delivered as a matching <file>.csv metadata sheet over the same connection.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
file |
path | required | |
description |
text |
optional, default ""
|
|
keywords |
string |
optional, default ""
|
|
profile |
profile |
optional, default shutterstock
|
| Name | Type | Notes |
|---|---|---|
name |
string | |
metadata_uploaded |
bool |
upload_folder
Destructive
Upload every photo/video in a folder to Shutterstock, skipping files already marked uploaded, with a shared description/keywords pair.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
description |
text |
optional, default ""
|
|
keywords |
string |
optional, default ""
|
|
recursive |
bool |
optional, default false
|
|
skip_uploaded |
bool |
optional, default true
|
|
profile |
profile |
optional, default shutterstock
|
| Name | Type | Notes |
|---|---|---|
count |
int | |
failed |
int | |
uploaded |
json |
python app.py --action check_auth --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.
run_action("shutterstock-upload", "check_auth", {}){
"id": "n0",
"app": "shutterstock-upload",
"action": "check_auth",
"params": {},
"inputs": {}
}python app.py --action upload --params '{"file": "D:/path/to/file"}'
# preview first - destructive action, nothing is changed:
python app.py --action upload --params '{"file": "D:/path/to/file"}' --dry-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("shutterstock-upload", "upload", {"file": "D:/path/to/file"})
# preview first:
run_action("shutterstock-upload", "upload", {"file": "D:/path/to/file"}, dry_run=true){
"id": "n0",
"app": "shutterstock-upload",
"action": "upload",
"params": {
"file": "D:/path/to/file"
},
"inputs": {}
}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-runRun from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.
run_action("shutterstock-upload", "upload_folder", {"folder": "D:/path/to/folder"})
# preview first:
run_action("shutterstock-upload", "upload_folder", {"folder": "D:/path/to/folder"}, dry_run=true){
"id": "n0",
"app": "shutterstock-upload",
"action": "upload_folder",
"params": {
"folder": "D:/path/to/folder"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.