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

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

| Group | Access | MCP name |
| --- | --- | --- |
| Articles | Read-only | `list_article_newsletters` |

## Description [#description]

The description the MCP server sends to the model, word for word. Its rules apply to every call.

> List the newsletters the user has enabled for Articles (the ones shown in WriteStack Articles; hidden newsletters are omitted). Returns publicationId, title, url, and isPrimary. BEFORE creating or pushing an article, call this tool, show the user these newsletters, and ASK which one to use. Never guess. Only these publicationIds are accepted.

## Arguments [#arguments]

This tool takes no arguments.

## 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_article_newsletters",
    "arguments": {}
  }
}
```

## Result [#result]

The result has `structuredContent` that matches this schema. The same data is also in `content` as JSON text.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `count` | `number` | Yes |  |
| `message` | `string` | No |  |
| `newsletters` | `object[]` | Yes |  |
| `newsletters[].isPrimary` | `boolean` | Yes |  |
| `newsletters[].publicationId` | `number` | Yes |  |
| `newsletters[].title` | `string \| null` | Yes |  |
| `newsletters[].url` | `string` | Yes |  |

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