docs

MCP tool

bulk_post

Create several posts at once

Creates or changes something · and, like everything an agent creates, it waits for a human in the approval queue.

What it does

Create up to 100 posts in one call. Each row is independent and runs the full single-post path — guardrails, plan limits, and copilot approval routing all apply, so in copilot mode the batch lands in the human approval queue. accounts entries may be account ids, platform:username, or a bare username when unambiguous. Returns a per-row report; check it — some rows can fail while others succeed. A held row carries its own approval_link, already written as a Markdown link; print each one verbatim so every post can be approved with one click. Give every row an idempotency_key of its own: a call that times out may still have written some rows, and a resend with the same keys returns those as repeated: true instead of posting them twice.

Arguments

NameTypeRequiredWhat it is
rowsarrayNoThe posts to create, one object per post. posts is accepted as the same thing.
postsarrayNoAlias 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

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