search_my_posts
Search My Posts. Find this writer's published Substack posts by words in the title or subtitle.
| Group | Access | MCP name |
|---|---|---|
| Published posts | Read-only | search_my_posts |
Description
The description the MCP server sends to the model, word for word. Its rules apply to every call.
Find this writer's published Substack posts by words in the title or subtitle. Also returns recent: the newest titles, subtitles and slugs, so you can judge a match by meaning when the words differ. Pass publicationId from list_my_newsletters when the post is on one newsletter. Do not put a newsletter name in query. Zero matches is a success with an empty posts list. hasRecordingTranscript is true when the post has a live, video or podcast recording whose transcript get_my_posts returns with includeTranscripts: true.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
limit | integer | No | Max matches 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. |
query | string | Yes | Words from the title or subtitle they named Min length 1. Max length 200. |
Example call
The smallest valid request: required arguments only, with placeholder values.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_my_posts",
"arguments": {
"query": "…"
}
}
}Annotations
| Hint | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | false |
The full input and output JSON Schemas for every tool are in /mcp-tools.json.
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.
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.