MCP tool
list_posts
List posts
Reads only · changes nothing, and needs no approval.
What it does
Recent posts with status, publishes, mediaIds and, on a rejected post, rejectionReason — the person's own words on what to change with update_post (often empty after a one-tap rejection). Filter with status (one or several), limit, and from/to on the scheduled time. A post still waiting carries approval_link. filter echoes what applied. An empty list with nothing filtered adds never_posted_message, which says what to offer them next.
Arguments
| Name | Type | Required | What it is |
|---|---|---|---|
| status | union | No | Only posts in this state (or any of these). Omit for all of them. |
| limit | number | No | How many, newest first (default 50, max 100) |
| from | string | No | Only posts whose scheduled time is at or after this instant (ISO 8601, Z or offset). With from or to the list runs soonest first and leaves out posts that have no time yet. |
| to | string | No | Only posts whose scheduled time is at or before this instant. |
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": "list_posts",
"arguments": {
"status": "…",
"limit": 0
}
}The other tools
Back to the MCP connector · What the MCP server is · Connect your assistant