MCP tool

bulk_post

Create several posts at once

Creates or changes something · and, like everything an agent creates, it is mailed to the project — and in copilot mode waits for a human in the approval queue.

What it does

Create AND SEND up to 100 DIFFERENT posts in one call: each row goes out at its scheduled_at, or now, unless the project holds agent posts. Each row runs the full single-post path — allowance, approval — and reports on its own, so some rows can land while others refuse. A row's media is media_ids (from upload_media) or media_urls. A held row carries its own approval_link. An idempotency_key per row makes a resend after a timeout answer repeated: true instead of a second post. NOT for one post going to several accounts: that is ONE create_post with every account in accounts, with any per-platform wording in platform_configurations.<platform>.caption.

Arguments

Name	Type	Required	What it is
rows	array	No	The posts to create, one object per post. `posts` is accepted as the same thing.
posts	array	No	Alias for `rows` — send one or the other.

Calling it

Any MCP client calls this by name once the connector is added. The address is the same for every tool:

https://xpost.to/api/mcp

A client that has signed in sends the tool name and its arguments:

{
  "name": "bulk_post",
  "arguments": {
    "rows": [],
    "posts": []
  }
}

The other tools

get_projectProject rules and settings list_accountsList connected accounts get_posting_rulesPosting rules per account upload_mediaAttach a picture, video or PDF create_postCreate a post list_postsList posts delete_postDelete a post update_postEdit a post retry_deliveryRetry a failed delivery take_down_postTake a live post down list_connection_issuesList account connection problems get_delivery_receiptDelivery receipt for a post get_post_metricsMetrics for a post get_insightsAccount insights get_top_postsTop posts get_best_timesBest times to post

Back to the MCP connector · What the MCP server is · Connect your assistant