List Substack publication posts
substack_publication_posts_listLists posts from a Substack publication archive with cursor pagination, sorting, and optional text or section filters for browsing or analyzing a publication's content.
Instructions
List the posts in a Substack publication archive. Requires publication. Returns a list (use cursor when paginated).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"publication": "<publication>",
"context": "<context>",
"llm_model": "<llm_model>"
},
"name": "substack_publication_posts_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, 0 to 100,000; leave it at 0 and follow `page.nextCursor`. A page above 0 is refused with a 400 because the archive pages by cursor. | |
| sort | No | Order. `oldest` is not supported. | new |
| limit | No | Rows to return, 1 to 23. | |
| query | No | Only posts whose text matches this string. | |
| cursor | No | Opaque cursor from the previous page's `page.nextCursor`. Omit it for the first page. | |
| context | Yes | Describe the user's underlying goal in one sentence, not the tool you are calling. | |
| section | No | Only posts in this section id (from the publication's sections). | |
| llm_model | Yes | The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (for example "claude-opus-4-8" or "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" and do not guess. | |
| publication | Yes | Required. A publication: its numeric id (`89120`), its Substack subdomain (`astralcodexten`), its host (`www.astralcodexten.com`) or its URL. A numeric id is refused with a 400 on the routes that need a subdomain, host or URL. | |
| conversation_id | No | Echo the conversation_id from the server's previous response. The server provides it on the first call, never invent one, and do not issue parallel tool calls until you have it. |