---
title: "list_posts: List posts"
description: "Read the social calendar."
canonical_url: "https://meetkuro.com/agents/tools/list_posts/"
updated: 2026-11-03
locale: "en"
tool: "list_posts"
scopes: ["social.read"]
---

# 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

| Name | Type | Required | Details |
| --- | --- | --- | --- |
| `post_id` | string | no | uuid |
| `from` | string | no | date-time |
| `to` | string | no | date-time |
| `drafts` | true | no | — |
| `attention` | true | no | — |

## Example call

A `tools/call` request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_posts",
    "arguments": {}
  }
}
```

## Input schema

As the server sends it in `tools/list`:

```json
{
  "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`](https://meetkuro.com/agents/tools/list_social_accounts.md): 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 reconnects it in the app) and `last_options` — the answers the reader gave that platform on their last post, which is the starting point for a new post's options.
- [`get_social_insights`](https://meetkuro.com/agents/tools/get_social_insights.md): 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, e.g.

---

## About Kuro

Kuro is an AI picture studio: prompt-driven images, clips, voice-overs and music, and storyboard-backed films with consistent characters across every scene.

Agents connect over MCP and can generate directly:

```
claude mcp add kuro https://api.meetkuro.com/mcp --transport http
```

The app is at https://app.meetkuro.com and requires an account.

Each guide, model page, comparison and free tool page on this site (not a tool's variants, and not the index pages) has a Markdown twin at its own URL plus `.md`, and so do /benchmarks/, the English /agents/ page (as /agents.md) and the MCP tool reference. Every tool: https://meetkuro.com/agents/tools/