get_my_posts
Get My Posts. Read up to 10 of this writer's published Substack posts in full, by the ids from list_my_posts or search_my_posts.
| Group | Access | MCP name |
|---|---|---|
| Published posts | Read-only | get_my_posts |
Description
The description the MCP server sends to the model, word for word. Its rules apply to every call.
Read up to 10 of this writer's published Substack posts in full, by the ids from list_my_posts or search_my_posts. Call it again for the next 10. The body is the written text only, cut at 12,000 characters (bodyTruncated says so). What was said in a live, video or podcast recording is not in the body: for posts with hasRecordingTranscript: true, pass includeTranscripts: true to also get the transcript, one paragraph per speaker turn labelled with the speaker's name when it could be matched to the post's bylines, otherwise Speaker 1, Speaker 2 and so on. Transcripts share one size budget per call, up to 60,000 characters each. Long transcripts come in parts: when transcriptNextOffset is not null, call again with just that post id and transcriptOffset set to transcriptNextOffset to read the next part. Transcripts are copied when WriteStack syncs the writer's posts through the browser extension, so a new live can take up to a day to appear. When you write notes from one of these posts, end each note with that post's url on its own line, exactly as returned, unless the user said not to; leave it out when url is null.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
includeTranscripts | boolean | No | Also return what was said in each post's live, video or podcast recording, for posts with hasRecordingTranscript: true. Transcripts are long and share one size budget, so pass only the posts whose recording you need. Default false. |
postIds | integer[] | Yes | Post ids from list_my_posts or search_my_posts. Up to 10 in one call. Min items 1. Max items 10. |
transcriptOffset | integer | No | Read the next part of one post's transcript: pass that single post id and its transcriptNextOffset from the previous call. Min 0. |
Example call
The smallest valid request: required arguments only, with placeholder values.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_my_posts",
"arguments": {
"postIds": [
1
]
}
}
}Annotations
| Hint | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | false |
The full input and output JSON Schemas for every tool are in /mcp-tools.json.