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. For the other clients, ChatGPT and Cursor among them, and what each tool does, see the social media MCP server page.

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_channelStart connecting an account, which you finish by signing in
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
set_video_coverChoose the picture a video is shown behind, or a frame of it
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
retry_postSend a post again where it failed, and only there
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. There is no surcharge for X: it is priced like every other network, per workspace.

Every other network

Instagram · TikTok · LinkedIn · YouTube · Facebook · Threads · Pinterest · Bluesky · Telegram