list_my_posts
List My Posts. List this writer's published Substack posts, newest first, with title, subtitle, date, free or paid audience, likes, comments, word count, url and a short preview.
| Group | Access | MCP name |
|---|---|---|
| Published posts | Read-only | list_my_posts |
Description
The description the MCP server sends to the model, word for word. Its rules apply to every call.
List this writer's published Substack posts, newest first, with title, subtitle, date, free or paid audience, likes, comments, word count, url and a short preview. Pass publicationId from list_my_newsletters to limit it to one newsletter, and audience to get only free or only paid posts. hasRecordingTranscript is true when the post has a live, video or podcast recording whose transcript get_my_posts returns with includeTranscripts: true. These are published posts, not WriteStack article drafts (use list_articles for those).
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
audience | string | No | everyone for free posts, only_paid for paywalled posts One of: "everyone", "only_paid". |
limit | integer | No | Max posts to return, newest first (default 15, max 30) Min 1. Max 30. Default 15. |
publicationId | integer | No | Limit to one newsletter. Use a publicationId from list_my_newsletters. |
Example call
The smallest valid request: required arguments only, with placeholder values.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "list_my_posts",
"arguments": {}
}
}Annotations
| Hint | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | false |
The full input and output JSON Schemas for every tool are in /mcp-tools.json.