discord-mcp

Instructions

Implementation Reference

• src/tools/forums.ts:192-201 (handler)

  Implementation of the discord_create_forum_channel tool handler.

  case "discord_create_forum_channel": {
    const guild = await discord.guilds.fetch(validateId(args.guild_id, "guild_id"));
    const created = await guild.channels.create({
      name: args.name as string,
      type: ChannelType.GuildForum,
      topic: args.topic as string | undefined,
      parent: args.category_id as string | undefined,
    });
    return { content: [{ type: "text", text: `✅ Forum channel #${created.name} created (id: ${created.id}).` }] };
  }

• src/tools/forums.ts:18-31 (schema)

  Tool definition and input schema for discord_create_forum_channel.

  {
    name: "discord_create_forum_channel",
    description: "Create a new forum channel in a guild.",
    inputSchema: {
      type: "object",
      properties: {
        guild_id: { type: "string" },
        name: { type: "string" },
        topic: { type: "string", description: "The forum channel guidelines/topic." },
        category_id: { type: "string", description: "Parent category ID (optional)." },
      },
      required: ["guild_id", "name"],
    },
  },