discord_create_forum_post

Create organized discussions in Discord forum channels by posting new topics with relevant tags to categorize conversations effectively.

Instructions

Creates a new post in a Discord forum channel with optional tags

Input Schema

TableJSON Schema

Name	Required	Description	Default
`forumChannelId`	Yes
`title`	Yes
`content`	Yes
`tags`	No

Implementation Reference

src/tools/forum.ts:70-128 (handler)

The core handler function that implements the discord_create_forum_post tool logic. It validates input with Zod, fetches the forum channel, handles tags, creates the thread/post, and returns success/error responses.

export const createForumPostHandler: ToolHandler = async (args, { client }) => {
  const { forumChannelId, title, content, tags } =
    CreateForumPostSchema.parse(args);

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

    const channel = await client.channels.fetch(forumChannelId);
    if (!channel || channel.type !== ChannelType.GuildForum) {
      return {
        content: [
          {
            type: 'text',
            text: `Channel ID ${forumChannelId} is not a forum channel.`,
          },
        ],
        isError: true,
      };
    }

    const forumChannel = channel as ForumChannel;

    // Get available tags in the forum
    const availableTags = forumChannel.availableTags;
    let selectedTagIds: string[] = [];

    // If tags are provided, find their IDs
    if (tags && tags.length > 0) {
      selectedTagIds = availableTags
        .filter((tag) => tags.includes(tag.name))
        .map((tag) => tag.id);
    }

    // Create the forum post
    const thread = await forumChannel.threads.create({
      name: title,
      message: {
        content,
      },
      appliedTags: selectedTagIds.length > 0 ? selectedTagIds : undefined,
    });

    return {
      content: [
        {
          type: 'text',
          text: `Successfully created forum post "${title}" with ID: ${thread.id}`,
        },
      ],
    };
  } catch (error) {
    return handleDiscordError(error);
  }
};

src/tool-list.ts:77-93 (schema)

The JSON input schema definition for the tool, used by MCP for tool listing and validation.

{
  name: 'discord_create_forum_post',
  description:
    'Creates a new post in a Discord forum channel with optional tags',
  inputSchema: {
    type: 'object',
    properties: {
      forumChannelId: { type: 'string' },
      title: { type: 'string' },
      content: { type: 'string' },
      tags: {
        type: 'array',
        items: { type: 'string' },
      },
    },
    required: ['forumChannelId', 'title', 'content'],
  },

src/server.ts:118-121 (registration)

Registration and dispatch in the main server handler switch statement, calling the createForumPostHandler.

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

src/server.ts:79-80 (registration)
Tool list registration where the schema is provided to MCP clients.
```
this.server.setRequestHandler(ListToolsRequestSchema, () => ({
  tools: toolList,
```

src/schemas.ts:16-22 (schema)

Zod schema for internal input validation in the handler.

export const CreateForumPostSchema = z.object({
  forumChannelId: z.string(),
  title: z.string(),
  content: z.string(),
  tags: z.array(z.string()).optional(),
});

MCP-Discord