discourse_get_draft

Retrieve saved draft content from Discourse forums using specific keys like 'new_topic' for new topics or 'topic_' for replies. Access incomplete posts to continue editing or review.

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)

Handler function for discourse_get_draft tool: parses input, fetches draft from /drafts/{key}.json, parses JSON data, formats output with preview and full JSON.

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 for discourse_get_draft: requires draft_key string, optional sequence number.

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:114-192 (registration)

Registration function registerGetDraft that calls server.registerTool for 'discourse_get_draft', defining title, description, schema, and handler.

export const registerGetDraft: RegisterFn = (server, ctx, _opts) => {
  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)"),
  });

  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 };
      }
    }
  );
};

Discourse MCP