MCP tool
get_top_posts
Top posts
Reads only · changes nothing, and needs no approval.
What it does
Best-performing deliveries ranked by a metric, with caption, platform, username, metrics and live URL — what worked for this audience, as a study aid rather than a template.
Arguments
| Name | Type | Required | What it is |
|---|---|---|---|
| metric | enum | No | Ranking metric (default engagement) |
| since_days | number | No | Window in days (default 30) |
| limit | number | No | Max results (default 10) |
| platform | string | No | Filter to one platform, e.g. instagram |
| format | enum | No | Filter to one format (feed post / reel / story) |
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_top_posts",
"arguments": {
"metric": "…",
"since_days": 0
}
}The other tools
get_projectProject rules and settingslist_accountsList connected accountsget_posting_rulesPosting rules per accountupload_mediaAttach a picture, video or PDFcreate_postCreate a postlist_postsList postsdelete_postDelete a postupdate_postEdit a postretry_deliveryRetry a failed deliverytake_down_postTake a live post downlist_connection_issuesList account connection problemsget_delivery_receiptDelivery receipt for a postbulk_postCreate several posts at onceget_post_metricsMetrics for a postget_insightsAccount insightsget_best_timesBest times to post
Back to the MCP connector · What the MCP server is · Connect your assistant