Post to Pinterest from an agent

PostWharf ships a Model Context Protocol server, so Claude and other MCP clients can draft, queue and check Pinterest 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 Pinterest

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

list_channelsFind your connected Pinterest account and its token health

describe_networksWhat Pinterest 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 Pinterest now

schedule_postQueue a post for a given time

schedule_manyQueue a month of Pinterest 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 Pinterest accepts

500 characters, counting the pin description. Up to 1 image or 1 video per post — Pinterest does not take both in the same post.

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

Asking for it in practice

# to Claude, with the connector attached
"Draft three Pinterest 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. Set a board per pin or as the account default; with none, a pin lands on a board that is not yours.

Every other network

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