Skip to content
DunSocial Docs

Posts and drafts

Schedule, publish, threads, and drafts through MCP tools.

Posts

Tool What it does
list_posts List posts (optional status, account, pagination)
get_post Get one post by id
schedule_post Schedule for later (socialAccountIds, content, scheduledAt, optional media/metadata)
publish_now Publish immediately
schedule_thread / publish_thread_now X/Twitter threads (2–25 tweets)
schedule_reddit_post / publish_reddit_now Reddit self, link, image, or video
schedule_instagram_post / publish_instagram_now Feed image, carousel, or Reel
schedule_pinterest_post / publish_pinterest_now Image Pin to a board
reschedule_post Change time and content (content and scheduledAt are both required)
cancel_post Cancel a scheduled post
delete_post Delete a post
get_x_cap_usage X monthly posting cap

Needs scopes: read tools use workspace:read; schedule/cancel need posts:schedule; publish tools need posts:publish; delete needs content:delete.

Example ask

Schedule this LinkedIn post for tomorrow at 15 UTC on account ACCOUNT_ID: “We just shipped …”

The assistant should call schedule_post with ISO scheduledAt and the social account id.

Drafts

Tool What it does
list_drafts / get_draft Browse drafts
create_draft / update_draft Save ideas (optional platforms, accounts, media, Pinterest options)
delete_draft Remove a draft

Drafts need drafts:write (delete needs content:delete). A draft never publishes by itself.

Platform metadata on generic tools

schedule_post and publish_now can carry metadata.reddit, metadata.instagram, or metadata.pinterest plus mediaUrls. Prefer the dedicated tools when available.