List posts
list_postsThe organization's posts, newest first. Filter by status to see what is waiting: "draft", "scheduled", "pending_approval" (waiting for someone who can publish to approve it in the app), "awaiting_plan" (held until the organization starts its trial or a plan), "queued", "processing", "complete", "failed" or "removed" (published, then deleted on the network). Each post's media holds mediaId values create_post accepts, so a post can be scheduled again without re-uploading. firstComment shows when the first comment goes out and whether it has (waiting, posted, failed + why). Returns { posts, nextCursor }: while nextCursor is not null, pass it back as cursor with the same filters for the next page.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_posts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | "createdAt" newest first (default), "scheduledAt" soonest first, "scheduledAtDesc" latest first. Posts with no time go last. | |
| limit | No | How many per page, up to 200. Default 50. | |
| cursor | No | nextCursor from the previous page. | |
| status | No | Only posts in this status. | |
| platform | No | Only posts to this network, e.g. "tiktok". | |
| accountId | No | Only posts to this account (an id from list_accounts). | |
| organizationId | No | Which organization to act in: an id from list_organizations. Leave out for this connection's default organization. | |
| scheduledAfter | No | Only posts scheduled at or after this ISO time. | |
| scheduledBefore | No | Only posts scheduled at or before this ISO time. |