Actions
Jump to:
upload_imageupload_foldercheck
Upload one image
upload_image
Destructive
Upload a single image to Imgur (anonymous upload) and return its URL and delete hash.
Inputs
| Name | Type | Required / default | Values and notes |
|---|
image |
path |
required
|
|
title |
string |
optional, default ""
|
|
description |
text |
optional, default ""
|
|
profile |
profile |
optional, default imgur
|
|
Outputs
| Name | Type | Notes |
|---|
id |
string |
|
url |
string |
|
deletehash |
string |
|
Upload a folder
upload_folder
Destructive
Upload every image in a folder to Imgur, skipping images already uploaded, and write the results to a urls.json in that folder.
Inputs
| Name | Type | Required / default | Values and notes |
|---|
folder |
path |
required
|
|
title |
string |
optional, default ""
|
|
description |
text |
optional, default ""
|
|
recursive |
bool |
optional, default false
|
|
skip_uploaded |
bool |
optional, default true
|
|
profile |
profile |
optional, default imgur
|
|
Outputs
| Name | Type | Notes |
|---|
count |
int |
|
failed |
int |
|
uploaded |
json |
|
urls_file |
string |
|
Verify the stored Imgur client-id works by calling the credits endpoint, without uploading anything.
Inputs
| Name | Type | Required / default | Values and notes |
|---|
profile |
profile |
optional, default imgur
|
|
Outputs
| Name | Type | Notes |
|---|
ok |
bool |
|
client_limit |
int |
|
client_remaining |
int |
|
Use it
Upload one image
Command line
shell
python app.py --action upload_image --params '{"image": "D:/path/to/image"}'
# preview first - destructive action, nothing is changed:
python app.py --action upload_image --params '{"image": "D:/path/to/image"}' --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("imgur-uploader", "upload_image", {"image": "D:/path/to/image"})
# preview first:
run_action("imgur-uploader", "upload_image", {"image": "D:/path/to/image"}, dry_run=true)
Workflow node
json
{
"id": "n0",
"app": "imgur-uploader",
"action": "upload_image",
"params": {
"image": "D:/path/to/image"
},
"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("imgur-uploader", "upload_folder", {"folder": "D:/path/to/folder"})
# preview first:
run_action("imgur-uploader", "upload_folder", {"folder": "D:/path/to/folder"}, dry_run=true)
Workflow node
json
{
"id": "n0",
"app": "imgur-uploader",
"action": "upload_folder",
"params": {
"folder": "D:/path/to/folder"
},
"inputs": {}
}
Check connection
Command line
shell
python app.py --action check --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("imgur-uploader", "check", {})
Workflow node
json
{
"id": "n0",
"app": "imgur-uploader",
"action": "check",
"params": {},
"inputs": {}
}
Example prompts
Things you can say to Claude, Cursor or Codex once the MCP server is registered.
- upload screenshot.png to Imgur and give me the link
- upload every image in D:/renders to Imgur, skipping ones I already posted, and save the links
- check that my Imgur client-id still works
