Submit artwork to DeviantArt via its OAuth2 API - stash and publish images as real deviations, using OAuth2 credentials kept in the vault, never in code.
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
Verify the stored DeviantArt OAuth2 credentials work by calling the API's whoami endpoint, without uploading anything.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
profile |
profile |
optional, default deviantart
|
| Name | Type | Notes |
|---|---|---|
ok |
bool | |
username |
string | |
userid |
string |
upload
Destructive
Stash and publish one image to DeviantArt as a real deviation, with a title, tags and a mature-content flag.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
image |
path | required | |
title |
string |
optional, default ""
|
|
tags |
string |
optional, default ""
|
|
mature |
bool |
optional, default false
|
|
profile |
profile |
optional, default deviantart
|
| Name | Type | Notes |
|---|---|---|
deviation_id |
string | |
url |
string |
upload_folder
Destructive
Stash and publish every image in a folder to DeviantArt, skipping files already uploaded, with a shared title pattern, tags and a mature-content flag.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
title |
string |
optional, default ""
|
|
tags |
string |
optional, default ""
|
|
mature |
bool |
optional, default false
|
|
recursive |
bool |
optional, default false
|
|
skip_uploaded |
bool |
optional, default true
|
|
profile |
profile |
optional, default deviantart
|
| 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("deviantart-uploader", "check_auth", {}){
"id": "n0",
"app": "deviantart-uploader",
"action": "check_auth",
"params": {},
"inputs": {}
}python app.py --action upload --params '{"image": "D:/path/to/image"}'
# preview first - destructive action, nothing is changed:
python app.py --action upload --params '{"image": "D:/path/to/image"}' --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("deviantart-uploader", "upload", {"image": "D:/path/to/image"})
# preview first:
run_action("deviantart-uploader", "upload", {"image": "D:/path/to/image"}, dry_run=true){
"id": "n0",
"app": "deviantart-uploader",
"action": "upload",
"params": {
"image": "D:/path/to/image"
},
"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("deviantart-uploader", "upload_folder", {"folder": "D:/path/to/folder"})
# preview first:
run_action("deviantart-uploader", "upload_folder", {"folder": "D:/path/to/folder"}, dry_run=true){
"id": "n0",
"app": "deviantart-uploader",
"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.