MCP tool

delete_post

Delete a post

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

What it does

Take a post you created off the board. Use it to clear up after yourself — a draft the user turned down, an extra version they didn't pick, a post they asked you to cancel — so nothing you wrote is left sitting in their approval queue for them to reject by hand. Works on your own posts only. A post waiting for approval, a draft, a rejected or failed one is deleted outright, permanently, along with its delivery records. A post that already has a time is taken OFF the schedule instead and handed back to the user, so it publishes nowhere; the reply says which happened, and you should repeat that to the user rather than reporting it as deleted. Anything already published, and anything a person approved that is no longer on the schedule, is theirs and is refused.

Arguments

Name	Type	Required	What it is
post_id	string	Yes	The post id from create_post

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": "delete_post",
  "arguments": {
    "post_id": "…"
  }
}

The other tools

get_projectProject rules and settings list_accountsList connected accounts get_posting_rulesPosting rules per account get_upload_ticketGet a one-file upload slot upload_mediaAttach a picture, video or PDF create_postCreate a post list_postsList posts 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 check_guardrailsCheck a caption against the rules bulk_postCreate several posts at once 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