Post text and image tweets to X/Twitter, one-off or as a batch from a folder, using OAuth1 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_loginpost_textpost_imagepost_from_folder
check_login
Verify the stored X/Twitter credentials work by asking the API who they belong to, without posting anything.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
profile |
profile |
optional, default twitter
|
| Name | Type | Notes |
|---|---|---|
ok |
bool | |
username |
string | |
user_id |
string |
post_text
Destructive
Post a plain text tweet.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
text |
text | required | |
profile |
profile |
optional, default twitter
|
| Name | Type | Notes |
|---|---|---|
tweet_id |
string | |
url |
string |
post_image
Destructive
Post a single image (or short video/GIF) with optional accompanying text.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
image |
path | required | |
text |
text |
optional, default ""
|
|
profile |
profile |
optional, default twitter
|
| Name | Type | Notes |
|---|---|---|
tweet_id |
string | |
url |
string | |
media_id |
string |
post_from_folder
Destructive
Post every new image in a folder as its own tweet, skipping files already posted. Each file's text comes from a same-named .txt file next to it if present, else a template, else the filename.
| Name | Type | Required / default | Values and notes |
|---|---|---|---|
folder |
path | required | |
text_template |
text |
optional, default ""
|
|
recursive |
bool |
optional, default false
|
|
skip_posted |
bool |
optional, default true
|
|
shuffle |
bool |
optional, default false
|
|
limit |
int |
optional, default 0
|
|
profile |
profile |
optional, default twitter
|
| Name | Type | Notes |
|---|---|---|
count |
int | |
failed |
int | |
posted |
json |
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.
run_action("twitter-poster", "check_login", {}){
"id": "n0",
"app": "twitter-poster",
"action": "check_login",
"params": {},
"inputs": {}
}python app.py --action post_text --params '{"text": "<text>"}'
# preview first - destructive action, nothing is changed:
python app.py --action post_text --params '{"text": "<text>"}' --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("twitter-poster", "post_text", {"text": "<text>"})
# preview first:
run_action("twitter-poster", "post_text", {"text": "<text>"}, dry_run=true){
"id": "n0",
"app": "twitter-poster",
"action": "post_text",
"params": {
"text": "<text>"
},
"inputs": {}
}python app.py --action post_image --params '{"image": "D:/path/to/image"}'
# preview first - destructive action, nothing is changed:
python app.py --action post_image --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("twitter-poster", "post_image", {"image": "D:/path/to/image"})
# preview first:
run_action("twitter-poster", "post_image", {"image": "D:/path/to/image"}, dry_run=true){
"id": "n0",
"app": "twitter-poster",
"action": "post_image",
"params": {
"image": "D:/path/to/image"
},
"inputs": {}
}python app.py --action post_from_folder --params '{"folder": "D:/path/to/folder"}'
# preview first - destructive action, nothing is changed:
python app.py --action post_from_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("twitter-poster", "post_from_folder", {"folder": "D:/path/to/folder"})
# preview first:
run_action("twitter-poster", "post_from_folder", {"folder": "D:/path/to/folder"}, dry_run=true){
"id": "n0",
"app": "twitter-poster",
"action": "post_from_folder",
"params": {
"folder": "D:/path/to/folder"
},
"inputs": {}
}Things you can say to Claude, Cursor or Codex once the MCP server is registered.