@mahesvara/discord-mcpserver 1.0.9 → 1.1.0

package/dist/schemas/channel.d.ts

@@ -25,30 +25,39 @@ export declare const GetChannelSchema: z.ZodObject<{
 export declare const CreateChannelSchema: z.ZodObject<{
     guild_id: z.ZodString;
     name: z.ZodString;
-    type: z.ZodDefault<z.ZodEnum<["text", "voice", "category"]>>;
+    type: z.ZodDefault<z.ZodEnum<["text", "voice", "category", "forum"]>>;
     topic: z.ZodOptional<z.ZodString>;
     parent_id: z.ZodOptional<z.ZodString>;
     nsfw: z.ZodOptional<z.ZodBoolean>;
     bitrate: z.ZodOptional<z.ZodNumber>;
     user_limit: z.ZodOptional<z.ZodNumber>;
+    default_reaction_emoji: z.ZodOptional<z.ZodString>;
+    default_sort_order: z.ZodOptional<z.ZodEnum<["latest_activity", "creation_date"]>>;
+    default_forum_layout: z.ZodOptional<z.ZodEnum<["not_set", "list_view", "gallery_view"]>>;
 }, "strict", z.ZodTypeAny, {
     name: string;
-    type: "text" | "voice" | "category";
+    type: "text" | "voice" | "category" | "forum";
     guild_id: string;
     topic?: string | undefined;
     parent_id?: string | undefined;
     nsfw?: boolean | undefined;
     bitrate?: number | undefined;
     user_limit?: number | undefined;
+    default_reaction_emoji?: string | undefined;
+    default_sort_order?: "latest_activity" | "creation_date" | undefined;
+    default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
 }, {
     name: string;
     guild_id: string;
-    type?: "text" | "voice" | "category" | undefined;
+    type?: "text" | "voice" | "category" | "forum" | undefined;
     topic?: string | undefined;
     parent_id?: string | undefined;
     nsfw?: boolean | undefined;
     bitrate?: number | undefined;
     user_limit?: number | undefined;
+    default_reaction_emoji?: string | undefined;
+    default_sort_order?: "latest_activity" | "creation_date" | undefined;
+    default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
 }>;
 export declare const DeleteChannelSchema: z.ZodObject<{
     channel_id: z.ZodString;
@@ -66,6 +75,9 @@ export declare const EditChannelSchema: z.ZodObject<{
     nsfw: z.ZodOptional<z.ZodBoolean>;
     bitrate: z.ZodOptional<z.ZodNumber>;
     user_limit: z.ZodOptional<z.ZodNumber>;
+    default_reaction_emoji: z.ZodOptional<z.ZodString>;
+    default_sort_order: z.ZodOptional<z.ZodEnum<["latest_activity", "creation_date"]>>;
+    default_forum_layout: z.ZodOptional<z.ZodEnum<["not_set", "list_view", "gallery_view"]>>;
 }, "strict", z.ZodTypeAny, {
     channel_id: string;
     name?: string | undefined;
@@ -74,6 +86,9 @@ export declare const EditChannelSchema: z.ZodObject<{
     nsfw?: boolean | undefined;
     bitrate?: number | undefined;
     user_limit?: number | undefined;
+    default_reaction_emoji?: string | undefined;
+    default_sort_order?: "latest_activity" | "creation_date" | undefined;
+    default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
     position?: number | undefined;
 }, {
     channel_id: string;
@@ -83,6 +98,9 @@ export declare const EditChannelSchema: z.ZodObject<{
     nsfw?: boolean | undefined;
     bitrate?: number | undefined;
     user_limit?: number | undefined;
+    default_reaction_emoji?: string | undefined;
+    default_sort_order?: "latest_activity" | "creation_date" | undefined;
+    default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
     position?: number | undefined;
 }>;
 export declare const PermissionOverwriteSchema: z.ZodObject<{

package/dist/schemas/channel.js

@@ -17,18 +17,18 @@ export const CreateChannelSchema = z.object({
         .min(1)
         .max(100)
         .describe("Channel name"),
-    type: z.enum(["text", "voice", "category"])
+    type: z.enum(["text", "voice", "category", "forum"])
         .default("text")
-        .describe("Channel type: 'text', 'voice', or 'category'"),
+        .describe("Channel type: 'text', 'voice', 'category', or 'forum'"),
     topic: z.string()
         .max(1024)
         .optional()
-        .describe("Channel topic (text channels only)"),
+        .describe("Channel topic (text/forum channels only)"),
     parent_id: ChannelIdSchema.optional()
         .describe("Category ID to create channel under (not for categories)"),
     nsfw: z.boolean()
         .optional()
-        .describe("Whether the channel is NSFW (text channels only)"),
+        .describe("Whether the channel is NSFW (text/forum channels only)"),
     bitrate: z.number()
         .int()
         .min(8000)
@@ -40,7 +40,16 @@ export const CreateChannelSchema = z.object({
         .min(0)
         .max(99)
         .optional()
-        .describe("User limit for voice channels (0 = unlimited)")
+        .describe("User limit for voice channels (0 = unlimited)"),
+    default_reaction_emoji: z.string()
+        .optional()
+        .describe("Default reaction emoji for forum posts - use emoji character (e.g., '👍') or custom emoji ID"),
+    default_sort_order: z.enum(["latest_activity", "creation_date"])
+        .optional()
+        .describe("Default sort order for forum posts"),
+    default_forum_layout: z.enum(["not_set", "list_view", "gallery_view"])
+        .optional()
+        .describe("Default layout for forum channel")
 }).strict();
 export const DeleteChannelSchema = z.object({
     channel_id: ChannelIdSchema
@@ -77,7 +86,16 @@ export const EditChannelSchema = z.object({
         .min(0)
         .max(99)
         .optional()
-        .describe("User limit for voice channels")
+        .describe("User limit for voice channels"),
+    default_reaction_emoji: z.string()
+        .optional()
+        .describe("Default reaction emoji for forum posts - use emoji character (e.g., '👍') or custom emoji ID, use 'none' to remove"),
+    default_sort_order: z.enum(["latest_activity", "creation_date"])
+        .optional()
+        .describe("Default sort order for forum posts"),
+    default_forum_layout: z.enum(["not_set", "list_view", "gallery_view"])
+        .optional()
+        .describe("Default layout for forum channel")
 }).strict();
 // Permission schemas
 export const PermissionOverwriteSchema = z.object({

package/dist/schemas/community.js

@@ -17,8 +17,8 @@ export const EditWelcomeScreenSchema = z.object({
     welcome_channels: z.array(z.object({
         channel_id: ChannelIdSchema,
         description: z.string().max(50).describe("Channel description (max 50 chars)"),
-        emoji_id: z.string().optional().describe("Custom emoji ID (for custom server emojis)"),
-        emoji_name: z.string().optional().describe("Emoji name (unicode emoji or custom emoji name)")
+        emoji_id: z.string().optional().describe("Custom emoji ID (only for custom server emojis)"),
+        emoji_name: z.string().optional().describe("Unicode emoji character (e.g., '👍') or custom emoji name if using emoji_id")
     }))
         .max(5)
         .optional()
@@ -44,8 +44,8 @@ export const EditOnboardingSchema = z.object({
             description: z.string().max(100).optional().describe("Option description"),
             emoji_id: z.string().optional().describe("Custom emoji ID"),
             emoji_name: z.string().optional().describe("Emoji name"),
-            role_ids: z.array(RoleIdSchema).optional().describe("Roles to assign when selected"),
-            channel_ids: z.array(ChannelIdSchema).optional().describe("Channels to show when selected")
+            role_ids: z.array(RoleIdSchema).optional().describe("Roles to assign when selected (at least one role OR channel required)"),
+            channel_ids: z.array(ChannelIdSchema).optional().describe("Channels to show when selected (at least one role OR channel required)")
         })).min(1).describe("Available options for this prompt")
     })).optional().describe("Onboarding prompts/questions"),
     default_channel_ids: z.array(ChannelIdSchema)

package/dist/tools/channel.js

@@ -1,6 +1,6 @@
 import { ListChannelsSchema, GetChannelSchema, CreateChannelSchema, DeleteChannelSchema, EditChannelSchema, SetChannelPermissionsSchema, RemoveChannelPermissionsSchema, GetChannelPermissionsSchema, SyncChannelPermissionsSchema, } from "../schemas/index.js";
 import { getClient, formatChannel, channelToMarkdown, formatResponse, truncateIfNeeded, getChannelType, } from "../services/discord.js";
-import { ChannelType, GuildChannel, PermissionsBitField, OverwriteType } from "discord.js";
+import { ChannelType, GuildChannel, PermissionsBitField, OverwriteType, SortOrderType, ForumLayoutType } from "discord.js";
 // Helper function to convert permission strings to bitfield
 function parsePermissions(permissions) {
     let bits = BigInt(0);
@@ -122,12 +122,15 @@ Returns:
 Args:
   - guild_id (string): Discord server/guild ID
   - name (string): Channel name
-  - type ('text' | 'voice' | 'category'): Channel type (default: 'text')
-  - topic (string, optional): Channel topic (text channels only)
+  - type ('text' | 'voice' | 'category' | 'forum'): Channel type (default: 'text')
+  - topic (string, optional): Channel topic (text/forum channels only)
   - parent_id (string, optional): Category ID to create channel under (not for categories)
-  - nsfw (boolean, optional): Whether the channel is NSFW (text channels only)
+  - nsfw (boolean, optional): Whether the channel is NSFW (text/forum channels only)
   - bitrate (number, optional): Bitrate for voice channels (8000-384000)
   - user_limit (number, optional): User limit for voice channels (0 = unlimited)
+  - default_reaction_emoji (string, optional): Default emoji for forum posts (emoji char or custom ID)
+  - default_sort_order ('latest_activity' | 'creation_date', optional): Sort order for forum posts
+  - default_forum_layout ('not_set' | 'list_view' | 'gallery_view', optional): Forum layout
 
 Returns:
   The created channel's details`,
@@ -156,6 +159,9 @@ Returns:
                 case "category":
                     channelType = ChannelType.GuildCategory;
                     break;
+                case "forum":
+                    channelType = ChannelType.GuildForum;
+                    break;
                 default:
                     channelType = ChannelType.GuildText;
             }
@@ -182,6 +188,33 @@ Returns:
                 if (params.user_limit !== undefined)
                     channelOptions.userLimit = params.user_limit;
             }
+            // Forum channel specific options
+            if (params.type === "forum") {
+                if (params.topic)
+                    channelOptions.topic = params.topic;
+                if (params.nsfw !== undefined)
+                    channelOptions.nsfw = params.nsfw;
+                if (params.default_reaction_emoji) {
+                    // Check if it's a custom emoji ID (numeric) or unicode emoji
+                    const isCustomEmoji = /^\d+$/.test(params.default_reaction_emoji);
+                    channelOptions.defaultReactionEmoji = isCustomEmoji
+                        ? { id: params.default_reaction_emoji }
+                        : { name: params.default_reaction_emoji };
+                }
+                if (params.default_sort_order) {
+                    channelOptions.defaultSortOrder = params.default_sort_order === "latest_activity"
+                        ? SortOrderType.LatestActivity
+                        : SortOrderType.CreationDate;
+                }
+                if (params.default_forum_layout) {
+                    const layoutMap = {
+                        not_set: ForumLayoutType.NotSet,
+                        list_view: ForumLayoutType.ListView,
+                        gallery_view: ForumLayoutType.GalleryView,
+                    };
+                    channelOptions.defaultForumLayout = layoutMap[params.default_forum_layout];
+                }
+            }
             const channel = await guild.channels.create(channelOptions);
             const typeLabel = params.type === "category" ? "category" : "channel";
             const prefix = params.type === "category" ? "📁" : "#";
@@ -248,6 +281,9 @@ Args:
   - nsfw (boolean, optional): Whether the channel is NSFW
   - bitrate (number, optional): Bitrate for voice channels (8000-384000)
   - user_limit (number, optional): User limit for voice channels
+  - default_reaction_emoji (string, optional): Default emoji for forum posts (emoji char or custom ID, 'none' to remove)
+  - default_sort_order ('latest_activity' | 'creation_date', optional): Sort order for forum posts
+  - default_forum_layout ('not_set' | 'list_view' | 'gallery_view', optional): Forum layout
 
 Returns:
   Updated channel details`,
@@ -284,6 +320,32 @@ Returns:
             if (params.parent_id !== undefined) {
                 updates.parent = params.parent_id === 'none' ? null : params.parent_id;
             }
+            // Forum channel specific options
+            if (params.default_reaction_emoji !== undefined) {
+                if (params.default_reaction_emoji === 'none') {
+                    updates.defaultReactionEmoji = null;
+                }
+                else {
+                    // Check if it's a custom emoji ID (numeric) or unicode emoji
+                    const isCustomEmoji = /^\d+$/.test(params.default_reaction_emoji);
+                    updates.defaultReactionEmoji = isCustomEmoji
+                        ? { id: params.default_reaction_emoji }
+                        : { name: params.default_reaction_emoji };
+                }
+            }
+            if (params.default_sort_order !== undefined) {
+                updates.defaultSortOrder = params.default_sort_order === "latest_activity"
+                    ? SortOrderType.LatestActivity
+                    : SortOrderType.CreationDate;
+            }
+            if (params.default_forum_layout !== undefined) {
+                const layoutMap = {
+                    not_set: ForumLayoutType.NotSet,
+                    list_view: ForumLayoutType.ListView,
+                    gallery_view: ForumLayoutType.GalleryView,
+                };
+                updates.defaultForumLayout = layoutMap[params.default_forum_layout];
+            }
             await channel.edit(updates);
             return {
                 content: [{ type: "text", text: `Updated channel ${params.channel_id}` }],

package/dist/tools/community.js

@@ -95,7 +95,8 @@ Returns:
                 updateData.welcomeChannels = params.welcome_channels.map(ch => ({
                     channel: ch.channel_id,
                     description: ch.description,
-                    emoji: ch.emoji_id ? { id: ch.emoji_id, name: ch.emoji_name } : ch.emoji_name ? { name: ch.emoji_name } : undefined,
+                    // For custom emojis, use emoji_id. For unicode emojis, just use the emoji string directly as emoji_name
+                    emoji: ch.emoji_id ? { id: ch.emoji_id, name: ch.emoji_name } : ch.emoji_name || undefined,
                 }));
             }
             const welcomeScreen = await guild.editWelcomeScreen(updateData);
@@ -234,14 +235,22 @@ Returns:
                     singleSelect: p.single_select,
                     required: p.required,
                     inOnboarding: p.in_onboarding,
-                    options: p.options.map(o => ({
-                        id: o.id,
-                        title: o.title,
-                        description: o.description,
-                        emoji: o.emoji_id ? { id: o.emoji_id, name: o.emoji_name } : o.emoji_name ? { name: o.emoji_name } : undefined,
-                        roleIds: o.role_ids,
-                        channelIds: o.channel_ids,
-                    })),
+                    options: p.options.map(o => {
+                        // Discord requires at least one role OR channel per option
+                        const hasRoles = o.role_ids && o.role_ids.length > 0;
+                        const hasChannels = o.channel_ids && o.channel_ids.length > 0;
+                        if (!hasRoles && !hasChannels) {
+                            throw new Error(`Option "${o.title}" must have at least one role_ids or channel_ids`);
+                        }
+                        return {
+                            id: o.id,
+                            title: o.title,
+                            description: o.description,
+                            emoji: o.emoji_id ? { id: o.emoji_id, name: o.emoji_name } : o.emoji_name || undefined,
+                            roleIds: o.role_ids || [],
+                            channelIds: o.channel_ids || [],
+                        };
+                    }),
                 }));
             }
             const onboarding = await guild.editOnboarding(updateData);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mahesvara/discord-mcpserver",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "MCP server for controlling Discord servers via bot token",
   "author": "Mahesvara",
   "repository": {