Tool reference

search_my_posts

Search My Posts. Find this writer's published Substack posts by words in the title or subtitle.

GroupAccessMCP name
Published postsRead-onlysearch_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

ArgumentTypeRequiredDescription
limitintegerNoMax matches to return, newest first (default 15, max 30) Min 1. Max 30. Default 15.
publicationIdintegerNoLimit to one newsletter. Use a publicationId from list_my_newsletters.
querystringYesWords 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

HintValue
readOnlyHinttrue
destructiveHintfalse
openWorldHintfalse

The full input and output JSON Schemas for every tool are in /mcp-tools.json.

On this page