Post to X from an agent

PostWharf ships a Model Context Protocol server, so Claude and other MCP clients can draft, queue and check X posts as tools rather than as scraped UI.

Overview API MCP CLI

Connect it

claude mcp add --transport http \
  wharf https://mcp.postwharf.com/mcp \
  --header "Authorization: Bearer $POSTWHARF_KEY"

The key scopes every call to one workspace, so an agent can only ever act on the brand you hand it. Find it in the dashboard under API keys.

What the agent can do with X

get_workspaceWhich brand this key reaches, and the clock it schedules on

list_channelsFind your connected X account and its token health

describe_networksWhat X takes: shapes, how many files, how much text, its own settings

connect_channelAttach a channel to the workspace

stage_uploadAn upload link and a public address for a file just made

upload_mediaRegister an image or video, get a media id

describe_mediaWrite or replace the alt text on an image

create_postPublish to X now

schedule_postQueue a post for a given time

schedule_manyQueue a month of X posts in one go

save_draftKeep a post without sending it, channels optional

list_draftsEverything saved and not yet sent

update_postChange the words, the time or the files on a draft or a queued post

publish_draftRelease a draft, now or at a time you pick

get_statusDelivery state, live URL, error text

list_queueWhat is scheduled and when

cancel_postPull something back out of the queue

list_eventsThe delivery receipt feed

healthWhether the API is reachable

What X accepts

280 characters, counting one post in a thread. Up to 4 images or 1 video per post — X does not take both in the same post.

Read from the table the API enforces, so a post over 280 is refused when you create it rather than truncated on the way to X.

Asking for it in practice

# to Claude, with the connector attached
"Draft three X posts about the new release,
 queue the best one for Tuesday morning,
 and tell me once it is live."

The agent drafts and queues; the delivery receipt tells you what actually published. X bills per post at the API level; link posts cost more than plain text.

Every other network

Instagram · TikTok · LinkedIn · YouTube · Facebook · Threads · Pinterest · Bluesky · Reddit · Telegram · Discord · Snapchat · WordPress