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

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

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

## Description [#description]

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

> Get one WriteStack article by ID, including markdown body, publicationId, contentVersion, and Substack draft/schedule status. The markdown may include headings, bold/italic/strike/code, lists, blockquotes, :::pullquote, :::callout, and :::paywall. ALWAYS call this immediately before update_article and pass the returned contentVersion as baseVersion — the user may have edited the article in WriteStack since you last saw it.

## Arguments [#arguments]

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `articleId` | `string` | Yes | WriteStack article ID |

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

## Result [#result]

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

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bodyMarkdown` | `string \| null` | Yes |  |
| `contentVersion` | `number` | No |  |
| `id` | `string` | Yes |  |
| `images` | `object[]` | No |  |
| `images[].s3Url` | `string` | Yes |  |
| `images[].substackUrl` | `string \| null` | Yes |  |
| `plannedForDate` | `string \| null` | Yes |  |
| `publicationId` | `number` | Yes |  |
| `publishAt` | `string \| null` | No |  |
| `status` | `string` | Yes |  |
| `substackDraftUrl` | `string \| null` | No |  |
| `substackScheduledAt` | `string \| null` | No |  |
| `substackSyncStatus` | `string` | No |  |
| `subtitle` | `string \| null` | Yes |  |
| `title` | `string` | Yes |  |
| `topic` | `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).