MCP tool
get_insights
Account insights
Reads only · changes nothing, and needs no approval.
What it does
Workspace engagement roll-up over a window: post/delivery counts, metric totals, and a per-platform breakdown. Use this for 'how are we doing' questions and to compare platforms.
Every answer carries coverage, and it is what tells an empty window apart from an unmeasurable one. deliveries is what actually went out, and the three counts under it add up to exactly that — with_metrics (what the totals are built from) + unreportable (no numbers, and none coming: deleted, expired, or never reported on) + awaiting (not in yet). unsupported is a SUBSET of unreportable, not a fourth bucket: deliveries nobody will ever report on — STORIES, which Instagram and Facebook report nothing about, ever. So format: "story" comes back with zero totals however many stories went out, and reporting that as "no stories were posted" is false: say the stories went out and their numbers are not something the platform gives anyone. ever_delivered ignores the window and separates "nothing in this window" from "nothing ever".
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
Back to the MCP connector · What the MCP server is · Connect your assistant