# search_my_posts (/docs/build/mcp-reference/search_my_posts)

{/* GENERATED by scripts/generate-mcp-reference.mjs from the MCP server tools/list. Do not edit. */}

| Group | Access | MCP name |
| --- | --- | --- |
| Published posts | Read-only | `search_my_posts` |

## Description [#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 [#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 [#example-call]

The smallest valid request: required arguments only, with placeholder values.

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "search_my_posts",
    "arguments": {
      "query": "…"
    }
  }
}
```

## Annotations [#annotations]

| Hint | Value |
| --- | --- |
| `readOnlyHint` | `true` |
| `destructiveHint` | `false` |
| `openWorldHint` | `false` |

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