MCP tool
get_insights
Account insights
Reads only · changes nothing, and needs no approval.
What it does
Engagement over a window: totals, per platform, per format. coverage says how much of the window the totals rest on: with_metrics + unreportable + awaiting = deliveries. Stories are never reported on by Instagram or Facebook, so format: "story" totals are zero however many went out. ever_delivered separates an empty window from an empty history.
Arguments
| Name | Type | Required | What it is |
|---|---|---|---|
| since_days | number | No | Window in days (default 30) |
| 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_insights",
"arguments": {
"since_days": 0,
"platform": "…"
}
}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_top_postsTop postsget_best_timesBest times to post
Back to the MCP connector · What the MCP server is · Connect your assistant