discord_get_forum_channels

Retrieve all forum channels from a Discord server to manage discussions and organize community conversations efficiently.

Instructions

Lists all forum channels in a specified Discord server (guild)

Input Schema

TableJSON Schema

Name	Required	Description	Default
`guildId`	Yes

Implementation Reference

src/index.ts:590-636 (handler)

Main execution logic for the discord_get_forum_channels tool. Parses input, checks client readiness, fetches guild and channels, filters for forum channels (ChannelType.GuildForum), formats and returns channel info (id, name, topic).

case "discord_get_forum_channels": {
  const { guildId } = GetForumChannelsSchema.parse(args);
  try {
    if (!client.isReady()) {
      return {
        content: [{ type: "text", text: "Discord client not logged in. Please use discord_login tool first." }],
        isError: true
      };
    }

    const guild = await client.guilds.fetch(guildId);
    if (!guild) {
      return {
        content: [{ type: "text", text: `Cannot find guild with ID: ${guildId}` }],
        isError: true
      };
    }

    // Fetch all channels from the guild
    const channels = await guild.channels.fetch();
    
    // Filter to get only forum channels
    const forumChannels = channels.filter(channel => channel?.type === ChannelType.GuildForum);
    
    if (forumChannels.size === 0) {
      return {
        content: [{ type: "text", text: `No forum channels found in guild: ${guild.name}` }]
      };
    }

    // Format forum channels information
    const forumInfo = forumChannels.map(channel => ({
      id: channel.id,
      name: channel.name,
      topic: channel.topic || "No topic set"
    }));

    return {
      content: [{ type: "text", text: JSON.stringify(forumInfo, null, 2) }]
    };
  } catch (error) {
    return {
      content: [{ type: "text", text: `Failed to fetch forum channels: ${error}` }],
      isError: true
    };
  }
}

src/index.ts:81-83 (schema)
Zod input schema definition requiring guildId string, used for validation in handler and reflected in tool registration.
```
const GetForumChannelsSchema = z.object({
    guildId: z.string()
});
```

src/index.ts:227-237 (registration)

Tool registration entry in ListToolsRequestSchema handler, defining name, description, and inputSchema matching the Zod schema.

{
  name: "discord_get_forum_channels",
  description: "Lists all forum channels in a specified Discord server (guild)",
  inputSchema: {
    type: "object",
    properties: {
      guildId: { type: "string" }
    },
    required: ["guildId"]
  }
},

MCP-Discord