discord_delete_forum_post

Delete Discord forum posts or threads to remove unwanted content. Specify a thread ID and optional reason for moderation.

Instructions

Deletes a forum post or thread with an optional reason

Input Schema

TableJSON Schema

Name	Required	Description	Default
`threadId`	Yes
`reason`	No

Implementation Reference

src/tools/forum.ts:225-263 (handler)

The main handler function that executes the deletion of a Discord forum post/thread. Validates input, checks client readiness, fetches the thread, deletes it, and returns success or error response.

export const deleteForumPostHandler: ToolHandler = async (args, { client }) => {
  const { threadId, reason } = DeleteForumPostSchema.parse(args);

  try {
    if (!client.isReady()) {
      return {
        content: [{ type: 'text', text: 'Discord client not logged in.' }],
        isError: true,
      };
    }

    const thread = await client.channels.fetch(threadId);
    if (!thread?.isThread()) {
      return {
        content: [
          {
            type: 'text',
            text: `Cannot find forum post/thread with ID: ${threadId}`,
          },
        ],
        isError: true,
      };
    }

    // Delete the forum post/thread
    await thread.delete(reason || 'Forum post deleted via API');

    return {
      content: [
        {
          type: 'text',
          text: `Successfully deleted forum post/thread with ID: ${threadId}`,
        },
      ],
    };
  } catch (error) {
    return handleDiscordError(error);
  }
};

src/schemas.ts:92-95 (schema)

Zod schema for input validation of the tool: requires threadId, optional reason.

export const DeleteForumPostSchema = z.object({
  threadId: z.string(),
  reason: z.string().optional(),
});

src/tool-list.ts:217-228 (registration)

Tool definition in the toolList array used for list_tools endpoint, including name, description, and input schema.

{
  name: 'discord_delete_forum_post',
  description: 'Deletes a forum post or thread with an optional reason',
  inputSchema: {
    type: 'object',
    properties: {
      threadId: { type: 'string' },
      reason: { type: 'string' },
    },
    required: ['threadId'],
  },
},

src/server.ts:133-136 (registration)

Dispatch registration in server.ts switch statement that routes tool calls to the deleteForumPostHandler.

case 'discord_delete_forum_post':
  this.logClientState('before discord_delete_forum_post handler');
  toolResponse = await deleteForumPostHandler(args, this.toolContext);
  return toolResponse;

src/tools/tools.ts:11-16 (helper)

Re-export of forum tool handlers including deleteForumPostHandler for centralized import in server and transport.

  createForumPostHandler,
  deleteForumPostHandler,
  getForumChannelsHandler,
  getForumPostHandler,
  replyToForumHandler,
} from './forum.js';

MCP-Discord