MCP tool

take_down_post

Take a live post down

Removes 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

Delete a published post from its platforms, by its post_id — every platform it is live on, or only platform. There is no need to call get_delivery_receipt first. There is no undo; reposting is a new post with a new URL. This is the person's own decision about their live post, not a cleanup step. Each delivery answers in deliveries: error_code never_went_out, account_gone or unsupported means the person removes it on the platform themselves; only platform_refused is retriable. delivery_id still takes down one delivery; a post id passed there answers is_post_id with the post's deliveries.

Arguments

Name	Type	Required	What it is
post_id	string	No	The post id from create_post or list_posts
platform	string	No	Only take it down here, e.g. `x`. Omit for every platform it is live on.
delivery_id	string	No	One delivery's `id` from get_delivery_receipt, instead of post_id

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

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 list_connection_issuesList account connection problems get_delivery_receiptDelivery receipt for a post 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