docs

MCP tool

retry_delivery

Retry a failed delivery

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

What it does

Send one FAILED delivery again — the row from get_delivery_receipt, by its id. This is the right answer to "it failed on Instagram": writing the post again would send a second copy to the accounts that worked. A delivery that succeeded is refused; there is nothing to repeat. A refusal answers in error_code, not in prose: already_succeeded (it landed — post_url comes back with it, report that and stop; with taken_down: true and no url it went out and was removed, so say that rather than offering a link), in_flight (still going, ask again later), already_claimed (something else is retrying it) or not_found. retriable is false when asking again can never change the answer — read those two fields rather than the sentence, and never loop on a refusal that says false.

Arguments

NameTypeRequiredWhat it is
delivery_idstringYesid of the failed row in get_delivery_receipt

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": "retry_delivery",
  "arguments": {
    "delivery_id": "…"
  }
}

The other tools

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