# list_my_posts (/docs/build/mcp-reference/list_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 | `list_my_posts` |

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

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

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

## 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).
