list_posts
List posts
Read the social calendar. Pass exactly one of: post_id for one post; from and to (ISO times, at most 62 days apart) for every post scheduled in that range; drafts: true for the posts that have no time yet; or attention: true for posts with a failed account, posts still sending 15 minutes after their due time, and scheduled posts aimed at an account that needs reconnecting. A delayed post is still unconfirmed: do not resend it. With none, the next 14 days. A post to three accounts is one post with three targets, each with its own status and, once out, its public URL.
Scope
social.read— Reads the connected social accounts and their posts.
Behaviour
- Read-only
- Reads the caller's own account and changes nothing.
- Stays in the account
- Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.
- Idempotent
- Calling it again with the same arguments has no further effect.
Inputs
post_idstring · optionaluuid
fromstring · optionaldate-time
tostring · optionaldate-time
draftstrue · optionalattentiontrue · optional
Example call
A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_posts",
"arguments": {}
}
}Input schema
As the server sends it in tools/list.
{
"type": "object",
"properties": {
"post_id": {
"type": "string",
"format": "uuid"
},
"from": {
"type": "string",
"format": "date-time"
},
"to": {
"type": "string",
"format": "date-time"
},
"drafts": {
"type": "boolean",
"const": true
},
"attention": {
"type": "boolean",
"const": true
}
},
"additionalProperties": false
}Related tools
- list_social_accounts
The TikTok, Instagram, YouTube and X accounts this reader connected, each with its status (`needs_reconnect` means posts to it will fail until the reader…
- get_social_insights
How the reader's published posts are doing: each post's latest views, likes, comments and shares per account (results), and, with timezone (an IANA zone,…