MCP Tools
block_list
List content blocks in the workspace.
List content blocks in the workspace. Can filter by kind (tweet, thread, note, etc), platform, status, or publishability.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
kind | string | No | Filter by: note, tweet, thread, linkedin, etc. |
platform | string | No | Filter by target platform |
status | string | No | Filter by: draft, scheduled, published, archived |
isPublishable | boolean | No | Filter by ready-to-publish status |
limit | number | No | Items per page (1-100, default: 20) |
offset | number | No | Items to skip (default: 0) |
Example
Prompt
Show me all my draft tweetsResponse
{
"blocks": [
{
"id": "block_abc123",
"kind": "tweet",
"content": "The skills that make you irreplaceable are the ones that can't be taught in a classroom.\n\nSpecific knowledge comes from curiosity + obsession, not curriculum.",
"platform": "x",
"status": "draft",
"isPublishable": true,
"derivedFrom": ["content_xyz789"],
"properties": {},
"createdAt": "2024-03-15T15: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z",
"updatedAt": "2024-03-15T15: <NUMBER>00</NUMBER>: <NUMBER>00</NUMBER>Z"
},
{
"id": "block_def456",
"kind": "tweet",
"content": "Most people optimize for the wrong thing.\n\nThey optimize for looking busy instead of being effective.",
"platform": "x",
"status": "draft",
"isPublishable": true,
"derivedFrom": [],
"properties": {},
"createdAt": "2024-03-14T10: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z",
"updatedAt": "2024-03-14T10: <NUMBER>30</NUMBER>: <NUMBER>00</NUMBER>Z"
}
],
"pagination": {
"total": 20,
"limit": 20,
"offset": 0,
"hasMore": false
}
}Response Fields
block
| Field | Type | Description |
|---|---|---|
id | string | Block UUID |
kind | string | Block type |
content | string | The content text |
platform | string | Target platform |
status | string | draft, scheduled, published, archived |
isPublishable | boolean | Whether block passes validation |
derivedFrom | string[] | Source content IDs |
createdAt | string | Creation timestamp |
updatedAt | string | Last update timestamp |
Filter Examples
| Use Case | Parameters |
|---|---|
| Ready-to-publish tweets | kind: "tweet", isPublishable: true |
| All LinkedIn content | platform: "linkedin" |
| Published threads | kind: "thread", status: "published" |
| All drafts | status: "draft" |
Use Cases
- Review all draft content before publishing
- Find content ready to post
- Audit published content history
- Manage content across platforms