discourse_get_draft
Retrieve saved draft content from Discourse forums using specific keys like 'new_topic' for new topics or 'topic_' for replies. Access partially composed posts to continue editing where you left off.
Instructions
Retrieve a specific draft by its key. Common keys: "new_topic" for new topic drafts, "topic_" for reply drafts.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_key | Yes | Draft key (e.g., "new_topic", "topic_123", "new_private_message") | |
| sequence | No | Expected sequence number (optional) |
Implementation Reference
- src/tools/builtin/drafts.ts:132-190 (handler)The handler function for the discourse_get_draft tool. It fetches the draft from the Discourse API using the provided draft_key and optional sequence, parses the JSON data, formats a markdown response with preview and full JSON, and handles errors.async (input: unknown, _extra: unknown) => { const { draft_key, sequence } = schema.parse(input); try { const { client } = ctx.siteState.ensureSelectedSite(); const params = new URLSearchParams(); if (typeof sequence === "number") params.set("sequence", String(sequence)); const url = `/drafts/${encodeURIComponent(draft_key)}.json${params.toString() ? `?${params}` : ""}`; const data = (await client.get(url)) as { draft?: string; draft_sequence?: number; }; if (!data?.draft) { return { content: [{ type: "text", text: `No draft found for key "${draft_key}".` }] }; } let parsedDraft: Record<string, unknown> = {}; try { parsedDraft = JSON.parse(data.draft); } catch { parsedDraft = { raw: data.draft }; } const lines = [`# Draft: \`${draft_key}\`\n`]; lines.push(`**Sequence:** ${data.draft_sequence ?? "unknown"}`); if (parsedDraft.title) lines.push(`**Title:** ${parsedDraft.title}`); if (parsedDraft.categoryId) lines.push(`**Category ID:** ${parsedDraft.categoryId}`); if (parsedDraft.tags && Array.isArray(parsedDraft.tags)) { lines.push(`**Tags:** ${(parsedDraft.tags as string[]).join(", ")}`); } if (parsedDraft.action) lines.push(`**Action:** ${parsedDraft.action}`); if (parsedDraft.reply) { lines.push(`\n**Content:**\n${parsedDraft.reply}`); } lines.push("\n```json"); lines.push( JSON.stringify( { draft_key, draft_sequence: data.draft_sequence, data: parsedDraft, }, null, 2 ) ); lines.push("```"); return { content: [{ type: "text", text: lines.join("\n") }] }; } catch (e: unknown) { const msg = e instanceof Error ? e.message : String(e); return { content: [{ type: "text", text: `Failed to get draft: ${msg}` }], isError: true }; } }
- src/tools/builtin/drafts.ts:115-122 (schema)Zod input schema defining draft_key (required string) and optional sequence (number). Used for validation in the tool handler.const schema = z.object({ draft_key: z .string() .min(1) .max(40) .describe('Draft key (e.g., "new_topic", "topic_123", "new_private_message")'), sequence: z.number().int().min(0).optional().describe("Expected sequence number (optional)"), });
- src/tools/builtin/drafts.ts:124-191 (registration)Registration of the discourse_get_draft tool using server.registerTool, including name, metadata (title, description, inputSchema), and handler function.server.registerTool( "discourse_get_draft", { title: "Get Draft", description: 'Retrieve a specific draft by its key. Common keys: "new_topic" for new topic drafts, "topic_<id>" for reply drafts.', inputSchema: schema.shape, }, async (input: unknown, _extra: unknown) => { const { draft_key, sequence } = schema.parse(input); try { const { client } = ctx.siteState.ensureSelectedSite(); const params = new URLSearchParams(); if (typeof sequence === "number") params.set("sequence", String(sequence)); const url = `/drafts/${encodeURIComponent(draft_key)}.json${params.toString() ? `?${params}` : ""}`; const data = (await client.get(url)) as { draft?: string; draft_sequence?: number; }; if (!data?.draft) { return { content: [{ type: "text", text: `No draft found for key "${draft_key}".` }] }; } let parsedDraft: Record<string, unknown> = {}; try { parsedDraft = JSON.parse(data.draft); } catch { parsedDraft = { raw: data.draft }; } const lines = [`# Draft: \`${draft_key}\`\n`]; lines.push(`**Sequence:** ${data.draft_sequence ?? "unknown"}`); if (parsedDraft.title) lines.push(`**Title:** ${parsedDraft.title}`); if (parsedDraft.categoryId) lines.push(`**Category ID:** ${parsedDraft.categoryId}`); if (parsedDraft.tags && Array.isArray(parsedDraft.tags)) { lines.push(`**Tags:** ${(parsedDraft.tags as string[]).join(", ")}`); } if (parsedDraft.action) lines.push(`**Action:** ${parsedDraft.action}`); if (parsedDraft.reply) { lines.push(`\n**Content:**\n${parsedDraft.reply}`); } lines.push("\n```json"); lines.push( JSON.stringify( { draft_key, draft_sequence: data.draft_sequence, data: parsedDraft, }, null, 2 ) ); lines.push("```"); return { content: [{ type: "text", text: lines.join("\n") }] }; } catch (e: unknown) { const msg = e instanceof Error ? e.message : String(e); return { content: [{ type: "text", text: `Failed to get draft: ${msg}` }], isError: true }; } } );