list_writing_pieces

Inputs

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "tweet",
        "thread",
        "blog"
      ]
    },
    "yoink_id": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 100
    }
  },
  "additionalProperties": false,
  "required": []
}

Outputs and behavior

List saved tweet, thread and blog drafts newest first, optionally filtered by kind or source item. Use to find a piece ID for get_writing_piece; use list_scripts for video-script versions. Returns pieces and count. The list contains local drafts, not posts fetched from social or publishing accounts.

The registry does not publish an output schema for this tool. The description above is its documented behavior; response fields beyond it are not specified here.

Example call

Example tool name and arguments, generated from the input schema. Replace placeholder strings and sample numbers with your own values. This is a request template, not a recorded call or response.

{
  "name": "list_writing_pieces",
  "arguments": {
    "yoink_id": "YOUR_YOINK_ID",
    "limit": 100
  }
}

Clients

This tool is available to MCP clients using stdio or http.

The registry records transport support, not individual client test results. See the MCP setup reference for named clients, configuration, and tool-list limits.