On by default

Drafts

Get Draft

read-onlyidempotentopen-world

discourse_get_draft

Retrieve a specific draft by key. Returns JSON with draft_key, sequence, and parsed data (title, reply, categoryId, tags, action).

Get Draft

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_get_draft",
    "arguments": {
        "draft_key": "string",
        "sequence": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_get_draft",
  "arguments": {
    "draft_key": "string",
    "sequence": 0
  }
});

result = await session.call_tool("discourse_get_draft", arguments={
  "draft_key": "string",
  "sequence": 0
})

Parameters

draft_keystringrequired

Draft key (e.g., "new_topic", "topic_123", "new_private_message")

sequenceinteger>= 0

Expected sequence number (optional)

Create/Save Draft

discourse_save_draft

Create or update a draft. Returns JSON with draft_key and new sequence number.

Create/Save Draft

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_save_draft",
    "arguments": {
        "draft_key": "string",
        "reply": "string",
        "title": "string",
        "category_id": 0,
        "tags": [
          "string"
        ],
        "sequence": 0,
        "action": "createTopic"
      }
  }
}

const result = await client.callTool({
  "name": "discourse_save_draft",
  "arguments": {
    "draft_key": "string",
    "reply": "string",
    "title": "string",
    "category_id": 0,
    "tags": [
      "string"
    ],
    "sequence": 0,
    "action": "createTopic"
  }
});

result = await session.call_tool("discourse_save_draft", arguments={
  "draft_key": "string",
  "reply": "string",
  "title": "string",
  "category_id": 0,
  "tags": [
    "string"
  ],
  "sequence": 0,
  "action": "createTopic"
})

Parameters

draft_keystringrequired

Draft key: "new_topic" for new topics, "topic_" for replies (e.g., "topic_123")

replystringrequired

The draft content/body text

titlestring

Topic title (required for new_topic drafts)

category_idinteger

Category ID for the topic

tagsArray<string>

Array of tag names

sequenceinteger>= 00

Current sequence number (use 0 for new drafts, or the sequence from get for updates)

actionstringcreateTopicreplyeditprivateMessage

Draft action type (defaults based on draft_key)

Delete Draft

discourse_delete_draft

Delete a draft by key. Requires current sequence number to prevent conflicts.

Delete Draft

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "discourse_delete_draft",
    "arguments": {
        "draft_key": "string",
        "sequence": 0
      }
  }
}

const result = await client.callTool({
  "name": "discourse_delete_draft",
  "arguments": {
    "draft_key": "string",
    "sequence": 0
  }
});

result = await session.call_tool("discourse_delete_draft", arguments={
  "draft_key": "string",
  "sequence": 0
})

Parameters

draft_keystringrequired

Draft key to delete

sequenceinteger>= 0required

Current sequence number (required for deletion)

Docs by Sourcey