MCP tool
get_post_metrics
Metrics for a post
Reads only · changes nothing, and needs no approval.
What it does
Per-platform engagement for ONE published post: views, likes, comments, shares, reach, saves, engagement, plus the live URL. A null metric means the platform doesn't report it (not zero); empty data means metrics haven't synced yet (they refresh roughly every 6h).
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": "get_post_metrics",
"arguments": {
"post_id": "…"
}
}The other tools
get_projectProject rules and settingslist_accountsList connected accountsget_posting_rulesPosting rules per accountget_upload_ticketGet a one-file upload slotupload_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 postcheck_guardrailsCheck a caption against the rulesbulk_postCreate several posts at onceget_insightsAccount insightsget_top_postsTop postsget_best_timesBest times to post
Back to the MCP connector · What the MCP server is · Connect your assistant