Tool reference/content

CONTENT

list_posts

List your saved Caroush content with cursor pagination. Status filters use destination delivery state; draft means never scheduled. Dates filter content creation time.

Read onlyread:content
Take the docs with youMarkdown for your editor or agent.
Download guide
TransportStreamable HTTP
Methodtools/call
ExecutionImmediate handler

Request contract

Input parameters

querystring
limitinteger
cursorinteger
statusstring
"draft""generated""scheduled""publishing""published""failed""awaiting_review""automation_pending"
platformstring
"tiktok""instagram""facebook""linkedin""twitter""threads""bluesky"
content_typestring
"text""image""carousel""video""story"
created_fromstring
created_untilstring

Exact JSON schemas

These are the schemas exported by the Caroush MCP server.

Input schema · JSON
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "type": "integer",
      "minimum": 1
    },
    "status": {
      "type": "string",
      "enum": [
        "draft",
        "generated",
        "scheduled",
        "publishing",
        "published",
        "failed",
        "awaiting_review",
        "automation_pending"
      ]
    },
    "platform": {
      "type": "string",
      "enum": [
        "tiktok",
        "instagram",
        "facebook",
        "linkedin",
        "twitter",
        "threads",
        "bluesky"
      ]
    },
    "content_type": {
      "type": "string",
      "enum": [
        "text",
        "image",
        "carousel",
        "video",
        "story"
      ]
    },
    "created_from": {
      "type": "string",
      "format": "date-time"
    },
    "created_until": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [],
  "additionalProperties": false
}

Read the actual outcome

A successful handler response does not necessarily mean generation or publication is finished. Follow the returned operation, native run or schedule status. Results and job states

Back to all 49 tools