MCP tool

get_best_times

Best times to post

Reads only · changes nothing, and needs no approval.

What it does

The workspace's best posting slots (weekday × hour, UTC) ranked by average engagement from its OWN past results. Use when choosing scheduled_at. READ signal BEFORE THE ORDER. A ranking always comes back, and it is only advice when there is something to rank on. "none" means no engagement has been recorded at all — the order is arbitrary, so say there is no history yet and pick a time on other grounds rather than presenting a slot as best. "thin" means some slot rests on one or two posts: name the sample count when you quote it. "ok" means every slot has three or more.

Arguments

Name	Type	Required	What it is
platform	string	No	Filter to one platform, e.g. instagram
format	enum	No	Filter to one format (feed post / reel / story)
since_days	number	No	Window in days (default 90)

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

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 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 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

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