@mahesvara/discord-mcpserver 1.1.0 → 1.1.2

package/README.md

@@ -7,14 +7,22 @@ An MCP (Model Context Protocol) server that enables LLMs to control Discord serv
 ### Guild/Server Management
 - `discord_list_guilds` - List all servers the bot has access to
 - `discord_get_guild` - Get detailed info about a specific server
+- `discord_edit_guild` - Edit server settings (name, verification level, system channels, etc.)
+- `discord_leave_guild` - Leave a server
 
 ### Channel Management
 - `discord_list_channels` - List channels in a server (filter by type)
-- `discord_get_channel` - Get channel details
-- `discord_create_channel` - Create text/voice channels **and categories**
-- `discord_edit_channel` - Edit channel name, topic, position, category, and more
+- `discord_get_channel` - Get channel details (includes forum tags for forum channels)
+- `discord_create_channel` - Create text/voice/forum channels and categories
+- `discord_edit_channel` - Edit channel name, topic, position, category, forum tags, and more
 - `discord_delete_channel` - Delete a channel or category
 
+### Forum Channel Features
+- Create forum channels with `type: "forum"`
+- Set default reaction emoji, sort order, and layout
+- Manage forum tags (create, edit, delete)
+- Tags support custom emojis and moderation settings
+
 ### Permission Management
 - `discord_set_channel_permissions` - Set permission overrides for roles/members on channels
 - `discord_remove_channel_permissions` - Remove permission overrides
@@ -39,6 +47,8 @@ An MCP (Model Context Protocol) server that enables LLMs to control Discord serv
 - `discord_ban_member` - Ban a member (with message deletion option)
 - `discord_unban_member` - Unban a user
 - `discord_set_nickname` - Set/clear member nickname
+- `discord_move_member` - Move member to a different voice channel
+- `discord_timeout_member` - Timeout/mute a member (up to 28 days)
 
 ### Role Management
 - `discord_list_roles` - List all server roles
@@ -50,12 +60,30 @@ An MCP (Model Context Protocol) server that enables LLMs to control Discord serv
 - `discord_set_role_positions` - Reorder role hierarchy
 
 ### Server Administration
-- `discord_edit_guild` - Edit server settings (name, verification level, system channels, etc.)
-- `discord_timeout_member` - Timeout/mute a member (up to 28 days)
 - `discord_list_bans` - List all banned users
 - `discord_prune_members` - Remove inactive members (with dry-run option)
 - `discord_get_audit_log` - View audit log entries
 
+### Community Features
+- `discord_get_community_settings` - View community settings (rules channel, features, etc.)
+- `discord_setup_community` - Configure community channels (rules, updates, safety alerts)
+
+### Welcome Screen
+- `discord_get_welcome_screen` - Get welcome screen configuration
+- `discord_edit_welcome_screen` - Edit welcome screen (description, channels, emojis)
+
+### Onboarding
+- `discord_get_onboarding` - Get onboarding configuration
+- `discord_edit_onboarding` - Edit existing onboarding settings
+- `discord_setup_onboarding` - Setup onboarding from scratch (prompts, default channels, roles)
+
+### Auto Moderation
+- `discord_list_automod_rules` - List auto moderation rules
+- `discord_get_automod_rule` - Get details of an auto mod rule
+- `discord_create_automod_rule` - Create auto moderation rule
+- `discord_edit_automod_rule` - Edit auto moderation rule
+- `discord_delete_automod_rule` - Delete auto moderation rule
+
 ### Emoji Management
 - `discord_list_emojis` - List custom emojis
 - `discord_create_emoji` - Create emoji from image URL
@@ -95,7 +123,7 @@ An MCP (Model Context Protocol) server that enables LLMs to control Discord serv
 
 ### 2. Invite the Bot to Your Server
 
-1. Go to OAuth2 → URL Generator
+1. Go to OAuth2 -> URL Generator
 2. Select scopes: `bot`, `applications.commands`
 3. Select bot permissions (choose based on features you need):
 
@@ -182,6 +210,7 @@ The server supports loading environment variables from a `.env` file in the curr
 DISCORD_BOT_TOKEN=your_bot_token_here
 TRANSPORT=http
 PORT=3000
+HOST=localhost
 ```
 
 | Variable | Description | Default |
@@ -189,6 +218,7 @@ PORT=3000
 | `DISCORD_BOT_TOKEN` | Your Discord bot token (required) | - |
 | `TRANSPORT` | Transport mode: `stdio` or `http` | `stdio` |
 | `PORT` | HTTP server port (when using http transport) | `3000` |
+| `HOST` | HTTP server host (use `0.0.0.0` for remote access) | `localhost` |
 
 ### HTTP Transport
 
@@ -196,17 +226,17 @@ For remote access, run the server with HTTP transport enabled:
 
 **Linux/macOS:**
 ```bash
-DISCORD_BOT_TOKEN=your_token TRANSPORT=http PORT=3000 discord-mcp-server
+DISCORD_BOT_TOKEN=your_token TRANSPORT=http PORT=3000 HOST=0.0.0.0 discord-mcp-server
 ```
 
 **Windows (Command Prompt):**
 ```cmd
-set DISCORD_BOT_TOKEN=your_token && set TRANSPORT=http && set PORT=3000 && discord-mcp-server
+set DISCORD_BOT_TOKEN=your_token && set TRANSPORT=http && set PORT=3000 && set HOST=0.0.0.0 && discord-mcp-server
 ```
 
 **Windows (PowerShell):**
 ```powershell
-$env:DISCORD_BOT_TOKEN="your_token"; $env:TRANSPORT="http"; $env:PORT="3000"; discord-mcp-server
+$env:DISCORD_BOT_TOKEN="your_token"; $env:TRANSPORT="http"; $env:PORT="3000"; $env:HOST="0.0.0.0"; discord-mcp-server
 ```
 
 **Or use a `.env` file** (works on all platforms):
@@ -229,6 +259,85 @@ Then configure your MCP client to connect via HTTP:
 
 ## Tool Examples
 
+### Create a Forum Channel with Tags
+
+```json
+{
+  "tool": "discord_create_channel",
+  "params": {
+    "guild_id": "1234567890123456789",
+    "name": "help-forum",
+    "type": "forum",
+    "topic": "Ask questions and get help",
+    "default_reaction_emoji": "✅",
+    "default_sort_order": "latest_activity",
+    "default_forum_layout": "list_view",
+    "available_tags": [
+      { "name": "Solved", "emoji_name": "✅", "moderated": false },
+      { "name": "Bug", "emoji_name": "🐛", "moderated": false },
+      { "name": "Question", "emoji_name": "❓", "moderated": false },
+      { "name": "Announcement", "emoji_name": "📢", "moderated": true }
+    ]
+  }
+}
+```
+
+### Setup Server Onboarding
+
+```json
+{
+  "tool": "discord_setup_onboarding",
+  "params": {
+    "guild_id": "1234567890123456789",
+    "default_channel_ids": ["1111111111111111111"],
+    "prompts": [
+      {
+        "type": "multiple_choice",
+        "title": "What are you interested in?",
+        "single_select": false,
+        "required": true,
+        "options": [
+          { "title": "Gaming", "emoji_name": "🎮", "role_ids": ["2222222222222222222"] },
+          { "title": "Tech", "emoji_name": "💻", "role_ids": ["3333333333333333333"] }
+        ]
+      }
+    ]
+  }
+}
+```
+
+### Configure Community Settings
+
+```json
+{
+  "tool": "discord_setup_community",
+  "params": {
+    "guild_id": "1234567890123456789",
+    "rules_channel_id": "1111111111111111111",
+    "public_updates_channel_id": "2222222222222222222",
+    "description": "A friendly gaming community",
+    "preferred_locale": "en-US"
+  }
+}
+```
+
+### Edit Welcome Screen
+
+```json
+{
+  "tool": "discord_edit_welcome_screen",
+  "params": {
+    "guild_id": "1234567890123456789",
+    "enabled": true,
+    "description": "Welcome to our server!",
+    "welcome_channels": [
+      { "channel_id": "1111111111111111111", "description": "Read the rules", "emoji_name": "📜" },
+      { "channel_id": "2222222222222222222", "description": "Introduce yourself", "emoji_name": "👋" }
+    ]
+  }
+}
+```
+
 ### Create a Category
 
 ```json
@@ -361,6 +470,7 @@ Depending on which tools you use, your bot needs these permissions:
 | Webhooks | Manage Webhooks |
 | Events | Manage Events |
 | Audit Log | View Audit Log |
+| Community/Onboarding | Manage Guild |
 
 ## Tool Examples
 

package/dist/schemas/channel.d.ts

@@ -34,6 +34,22 @@ export declare const CreateChannelSchema: z.ZodObject<{
     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"]>>;
+    available_tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        moderated: z.ZodOptional<z.ZodBoolean>;
+        emoji_id: z.ZodOptional<z.ZodString>;
+        emoji_name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+    }, {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+    }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     name: string;
     type: "text" | "voice" | "category" | "forum";
@@ -46,6 +62,12 @@ export declare const CreateChannelSchema: z.ZodObject<{
     default_reaction_emoji?: string | undefined;
     default_sort_order?: "latest_activity" | "creation_date" | undefined;
     default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
+    available_tags?: {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+    }[] | undefined;
 }, {
     name: string;
     guild_id: string;
@@ -58,6 +80,12 @@ export declare const CreateChannelSchema: z.ZodObject<{
     default_reaction_emoji?: string | undefined;
     default_sort_order?: "latest_activity" | "creation_date" | undefined;
     default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
+    available_tags?: {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+    }[] | undefined;
 }>;
 export declare const DeleteChannelSchema: z.ZodObject<{
     channel_id: z.ZodString;
@@ -78,6 +106,25 @@ export declare const EditChannelSchema: z.ZodObject<{
     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"]>>;
+    available_tags: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        name: z.ZodString;
+        moderated: z.ZodOptional<z.ZodBoolean>;
+        emoji_id: z.ZodOptional<z.ZodString>;
+        emoji_name: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+        id?: string | undefined;
+    }, {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+        id?: string | undefined;
+    }>, "many">>;
 }, "strict", z.ZodTypeAny, {
     channel_id: string;
     name?: string | undefined;
@@ -89,6 +136,13 @@ export declare const EditChannelSchema: z.ZodObject<{
     default_reaction_emoji?: string | undefined;
     default_sort_order?: "latest_activity" | "creation_date" | undefined;
     default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
+    available_tags?: {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+        id?: string | undefined;
+    }[] | undefined;
     position?: number | undefined;
 }, {
     channel_id: string;
@@ -101,6 +155,13 @@ export declare const EditChannelSchema: z.ZodObject<{
     default_reaction_emoji?: string | undefined;
     default_sort_order?: "latest_activity" | "creation_date" | undefined;
     default_forum_layout?: "not_set" | "list_view" | "gallery_view" | undefined;
+    available_tags?: {
+        name: string;
+        moderated?: boolean | undefined;
+        emoji_id?: string | undefined;
+        emoji_name?: string | undefined;
+        id?: string | undefined;
+    }[] | undefined;
     position?: number | undefined;
 }>;
 export declare const PermissionOverwriteSchema: z.ZodObject<{

package/dist/schemas/channel.js

@@ -49,7 +49,16 @@ export const CreateChannelSchema = z.object({
         .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")
+        .describe("Default layout for forum channel"),
+    available_tags: z.array(z.object({
+        name: z.string().max(20).describe("Tag name (max 20 chars)"),
+        moderated: z.boolean().optional().describe("Whether only moderators can apply this tag"),
+        emoji_id: z.string().optional().describe("Custom emoji ID for the tag"),
+        emoji_name: z.string().optional().describe("Unicode emoji for the tag (e.g., '🎮')")
+    }))
+        .max(20)
+        .optional()
+        .describe("Available tags for forum posts (max 20 tags)")
 }).strict();
 export const DeleteChannelSchema = z.object({
     channel_id: ChannelIdSchema
@@ -95,7 +104,17 @@ export const EditChannelSchema = z.object({
         .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")
+        .describe("Default layout for forum channel"),
+    available_tags: z.array(z.object({
+        id: z.string().optional().describe("Tag ID (required when editing existing tags)"),
+        name: z.string().max(20).describe("Tag name (max 20 chars)"),
+        moderated: z.boolean().optional().describe("Whether only moderators can apply this tag"),
+        emoji_id: z.string().optional().describe("Custom emoji ID for the tag"),
+        emoji_name: z.string().optional().describe("Unicode emoji for the tag (e.g., '🎮')")
+    }))
+        .max(20)
+        .optional()
+        .describe("Available tags for forum posts (max 20 tags)")
 }).strict();
 // Permission schemas
 export const PermissionOverwriteSchema = z.object({

package/dist/schemas/community.d.ts

@@ -80,17 +80,17 @@ export declare const EditOnboardingSchema: z.ZodObject<{
         }, "strip", z.ZodTypeAny, {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }, {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }>, "many">;
@@ -99,9 +99,9 @@ export declare const EditOnboardingSchema: z.ZodObject<{
         options: {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }[];
@@ -115,9 +115,9 @@ export declare const EditOnboardingSchema: z.ZodObject<{
         options: {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }[];
@@ -138,9 +138,9 @@ export declare const EditOnboardingSchema: z.ZodObject<{
         options: {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }[];
@@ -160,9 +160,9 @@ export declare const EditOnboardingSchema: z.ZodObject<{
         options: {
             title: string;
             description?: string | undefined;
-            id?: string | undefined;
             emoji_id?: string | undefined;
             emoji_name?: string | undefined;
+            id?: string | undefined;
             role_ids?: string[] | undefined;
             channel_ids?: string[] | undefined;
         }[];
@@ -175,7 +175,145 @@ export declare const EditOnboardingSchema: z.ZodObject<{
     default_channel_ids?: string[] | undefined;
     mode?: "onboarding_default" | "onboarding_advanced" | undefined;
 }>;
+export declare const SetupOnboardingSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    default_channel_ids: z.ZodArray<z.ZodString, "many">;
+    prompts: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["multiple_choice", "dropdown"]>;
+        title: z.ZodString;
+        single_select: z.ZodDefault<z.ZodBoolean>;
+        required: z.ZodDefault<z.ZodBoolean>;
+        in_onboarding: z.ZodDefault<z.ZodBoolean>;
+        options: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            emoji_id: z.ZodOptional<z.ZodString>;
+            emoji_name: z.ZodOptional<z.ZodString>;
+            role_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            channel_ids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }, {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        options: {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }[];
+        type: "multiple_choice" | "dropdown";
+        single_select: boolean;
+        required: boolean;
+        in_onboarding: boolean;
+    }, {
+        title: string;
+        options: {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }[];
+        type: "multiple_choice" | "dropdown";
+        single_select?: boolean | undefined;
+        required?: boolean | undefined;
+        in_onboarding?: boolean | undefined;
+    }>, "many">;
+    mode: z.ZodDefault<z.ZodEnum<["onboarding_default", "onboarding_advanced"]>>;
+    enabled: z.ZodDefault<z.ZodBoolean>;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    enabled: boolean;
+    prompts: {
+        title: string;
+        options: {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }[];
+        type: "multiple_choice" | "dropdown";
+        single_select: boolean;
+        required: boolean;
+        in_onboarding: boolean;
+    }[];
+    default_channel_ids: string[];
+    mode: "onboarding_default" | "onboarding_advanced";
+}, {
+    guild_id: string;
+    prompts: {
+        title: string;
+        options: {
+            title: string;
+            description?: string | undefined;
+            emoji_id?: string | undefined;
+            emoji_name?: string | undefined;
+            role_ids?: string[] | undefined;
+            channel_ids?: string[] | undefined;
+        }[];
+        type: "multiple_choice" | "dropdown";
+        single_select?: boolean | undefined;
+        required?: boolean | undefined;
+        in_onboarding?: boolean | undefined;
+    }[];
+    default_channel_ids: string[];
+    enabled?: boolean | undefined;
+    mode?: "onboarding_default" | "onboarding_advanced" | undefined;
+}>;
+export declare const SetupCommunitySchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    rules_channel_id: z.ZodString;
+    public_updates_channel_id: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    preferred_locale: z.ZodOptional<z.ZodString>;
+    safety_alerts_channel_id: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    guild_id: string;
+    rules_channel_id: string;
+    public_updates_channel_id: string;
+    description?: string | undefined;
+    preferred_locale?: string | undefined;
+    safety_alerts_channel_id?: string | undefined;
+}, {
+    guild_id: string;
+    rules_channel_id: string;
+    public_updates_channel_id: string;
+    description?: string | undefined;
+    preferred_locale?: string | undefined;
+    safety_alerts_channel_id?: string | undefined;
+}>;
+export declare const GetCommunitySettingsSchema: z.ZodObject<{
+    guild_id: z.ZodString;
+    response_format: z.ZodDefault<z.ZodNativeEnum<typeof import("../types.js").ResponseFormat>>;
+}, "strict", z.ZodTypeAny, {
+    response_format: import("../types.js").ResponseFormat;
+    guild_id: string;
+}, {
+    guild_id: string;
+    response_format?: import("../types.js").ResponseFormat | undefined;
+}>;
 export type GetWelcomeScreenInput = z.infer<typeof GetWelcomeScreenSchema>;
 export type EditWelcomeScreenInput = z.infer<typeof EditWelcomeScreenSchema>;
 export type GetOnboardingInput = z.infer<typeof GetOnboardingSchema>;
 export type EditOnboardingInput = z.infer<typeof EditOnboardingSchema>;
+export type SetupOnboardingInput = z.infer<typeof SetupOnboardingSchema>;
+export type SetupCommunityInput = z.infer<typeof SetupCommunitySchema>;
+export type GetCommunitySettingsInput = z.infer<typeof GetCommunitySettingsSchema>;

package/dist/schemas/community.js

@@ -58,3 +58,54 @@ export const EditOnboardingSchema = z.object({
         .optional()
         .describe("Onboarding mode")
 }).strict();
+// Setup Onboarding schema - for initial configuration
+export const SetupOnboardingSchema = z.object({
+    guild_id: GuildIdSchema,
+    default_channel_ids: z.array(ChannelIdSchema)
+        .min(1)
+        .describe("Channels shown to new members by default (at least one required)"),
+    prompts: z.array(z.object({
+        type: z.enum(["multiple_choice", "dropdown"]).describe("Prompt type"),
+        title: z.string().max(100).describe("Prompt title"),
+        single_select: z.boolean().default(true).describe("Whether only one option can be selected"),
+        required: z.boolean().default(false).describe("Whether this prompt is required"),
+        in_onboarding: z.boolean().default(true).describe("Whether shown during onboarding"),
+        options: z.array(z.object({
+            title: z.string().max(50).describe("Option title"),
+            description: z.string().max(100).optional().describe("Option description"),
+            emoji_id: z.string().optional().describe("Custom emoji ID"),
+            emoji_name: z.string().optional().describe("Unicode emoji or custom emoji name"),
+            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")
+    })).min(1).describe("Onboarding prompts/questions (at least one required)"),
+    mode: z.enum(["onboarding_default", "onboarding_advanced"])
+        .default("onboarding_default")
+        .describe("Onboarding mode"),
+    enabled: z.boolean()
+        .default(true)
+        .describe("Whether to enable onboarding after setup")
+}).strict();
+// Setup Community schema
+export const SetupCommunitySchema = z.object({
+    guild_id: GuildIdSchema,
+    rules_channel_id: ChannelIdSchema
+        .describe("Channel for server rules (required for Community)"),
+    public_updates_channel_id: ChannelIdSchema
+        .describe("Channel for Discord community updates (required for Community)"),
+    description: z.string()
+        .max(120)
+        .optional()
+        .describe("Server description (max 120 chars)"),
+    preferred_locale: z.string()
+        .optional()
+        .describe("Preferred language (e.g., 'en-US', 'de', 'fr')"),
+    safety_alerts_channel_id: ChannelIdSchema
+        .optional()
+        .describe("Channel for safety alerts from Discord")
+}).strict();
+// Get Community Settings schema
+export const GetCommunitySettingsSchema = z.object({
+    guild_id: GuildIdSchema,
+    response_format: ResponseFormatSchema
+}).strict();

package/dist/services/discord.js

@@ -74,6 +74,19 @@ export function formatChannel(channel) {
     if (channel.type === ChannelType.GuildText && 'topic' in channel) {
         baseChannel.topic = channel.topic ?? undefined;
     }
+    // Forum channel specific fields
+    if (channel.type === ChannelType.GuildForum && 'availableTags' in channel) {
+        const forumChannel = channel;
+        baseChannel.availableTags = forumChannel.availableTags?.map((tag) => ({
+            id: tag.id,
+            name: tag.name,
+            moderated: tag.moderated,
+            emoji: tag.emoji ? { id: tag.emoji.id, name: tag.emoji.name } : null,
+        }));
+        baseChannel.defaultReactionEmoji = forumChannel.defaultReactionEmoji;
+        baseChannel.defaultSortOrder = forumChannel.defaultSortOrder;
+        baseChannel.defaultForumLayout = forumChannel.defaultForumLayout;
+    }
     return baseChannel;
 }
 /**

package/dist/tools/channel.js

@@ -131,6 +131,11 @@ Args:
   - 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
+  - available_tags (array, optional): Tags for forum posts (max 20)
+    - name (string): Tag name (max 20 chars)
+    - moderated (boolean, optional): Only mods can apply this tag
+    - emoji_name (string, optional): Unicode emoji (e.g., '🎮')
+    - emoji_id (string, optional): Custom emoji ID
 
 Returns:
   The created channel's details`,
@@ -214,6 +219,17 @@ Returns:
                     };
                     channelOptions.defaultForumLayout = layoutMap[params.default_forum_layout];
                 }
+                if (params.available_tags && params.available_tags.length > 0) {
+                    channelOptions.availableTags = params.available_tags.map(tag => ({
+                        name: tag.name,
+                        moderated: tag.moderated ?? false,
+                        emoji: tag.emoji_id
+                            ? { id: tag.emoji_id, name: tag.emoji_name }
+                            : tag.emoji_name
+                                ? { id: null, name: tag.emoji_name }
+                                : undefined,
+                    }));
+                }
             }
             const channel = await guild.channels.create(channelOptions);
             const typeLabel = params.type === "category" ? "category" : "channel";
@@ -284,6 +300,14 @@ Args:
   - 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
+  - available_tags (array, optional): Tags for forum posts (max 20)
+    WARNING: This REPLACES all existing tags! To keep existing tags, first use discord_get_channel
+    to get current tags with their IDs, then include them in this array with their id field.
+    - id (string): Tag ID - REQUIRED to preserve existing tags, omit only for new tags
+    - name (string): Tag name (max 20 chars)
+    - moderated (boolean, optional): Only mods can apply this tag
+    - emoji_name (string, optional): Unicode emoji (e.g., '🎮')
+    - emoji_id (string, optional): Custom emoji ID
 
 Returns:
   Updated channel details`,
@@ -346,6 +370,18 @@ Returns:
                 };
                 updates.defaultForumLayout = layoutMap[params.default_forum_layout];
             }
+            if (params.available_tags !== undefined) {
+                updates.availableTags = params.available_tags.map(tag => ({
+                    id: tag.id,
+                    name: tag.name,
+                    moderated: tag.moderated ?? false,
+                    emoji: tag.emoji_id
+                        ? { id: tag.emoji_id, name: tag.emoji_name }
+                        : tag.emoji_name
+                            ? { id: null, name: tag.emoji_name }
+                            : undefined,
+                }));
+            }
             await channel.edit(updates);
             return {
                 content: [{ type: "text", text: `Updated channel ${params.channel_id}` }],

package/dist/tools/community.js

@@ -1,4 +1,4 @@
-import { GetWelcomeScreenSchema, EditWelcomeScreenSchema, GetOnboardingSchema, EditOnboardingSchema, } from "../schemas/index.js";
+import { GetWelcomeScreenSchema, EditWelcomeScreenSchema, GetOnboardingSchema, EditOnboardingSchema, SetupOnboardingSchema, SetupCommunitySchema, GetCommunitySettingsSchema, } from "../schemas/index.js";
 import { getClient, formatResponse, } from "../services/discord.js";
 export function registerCommunityTools(server) {
     // ============================================================================
@@ -240,15 +240,15 @@ Returns:
                         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`);
+                            throw new Error(`Option "${o.title}" must have at least one role_ids or channel_ids. Received: role_ids=${JSON.stringify(o.role_ids)}, channel_ids=${JSON.stringify(o.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 || [],
+                            roles: o.role_ids || [],
+                            channels: o.channel_ids || [],
                         };
                     }),
                 }));
@@ -265,4 +265,236 @@ Returns:
             };
         }
     });
+    server.registerTool("discord_setup_onboarding", {
+        title: "Setup Server Onboarding",
+        description: `Setup and enable onboarding for a server from scratch.
+
+This tool configures the complete onboarding experience for new members.
+The server must have Community features enabled.
+
+Requirements:
+- Server must have Community features enabled (done in Discord Server Settings)
+- At least one default channel must be specified
+- At least one prompt with options must be provided
+- Each option must have at least one role_ids OR channel_ids
+
+Args:
+  - guild_id (string): Discord server/guild ID
+  - default_channel_ids (string[]): Channels shown to all new members (required, at least one)
+  - prompts (array): Onboarding questions (required, at least one)
+    - type ('multiple_choice' | 'dropdown'): Prompt type
+    - title (string): Question title
+    - single_select (boolean): Allow only one selection (default: true)
+    - required (boolean): Must answer to continue (default: false)
+    - in_onboarding (boolean): Show during onboarding (default: true)
+    - options (array): Available choices (at least one)
+      - title (string): Option title
+      - description (string, optional): Option description
+      - emoji_name (string, optional): Unicode emoji (e.g., '🎮')
+      - role_ids (string[], optional): Roles to assign when selected
+      - channel_ids (string[], optional): Channels to show when selected
+  - mode ('onboarding_default' | 'onboarding_advanced', optional): Mode (default: 'onboarding_default')
+  - enabled (boolean, optional): Enable after setup (default: true)
+
+Returns:
+  Confirmation with onboarding status`,
+        inputSchema: SetupOnboardingSchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await getClient();
+            const guild = client.guilds.cache.get(params.guild_id);
+            if (!guild) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Guild not found: ${params.guild_id}` }],
+                };
+            }
+            // Check if community features are enabled
+            if (!guild.features.includes('COMMUNITY')) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Server "${guild.name}" does not have Community features enabled. Please enable Community in Discord Server Settings > Enable Community first.` }],
+                };
+            }
+            const promptTypeMap = { multiple_choice: 0, dropdown: 1 };
+            const modeMap = { onboarding_default: 0, onboarding_advanced: 1 };
+            // Build the onboarding data
+            const onboardingData = {
+                enabled: params.enabled ?? true,
+                defaultChannelIds: params.default_channel_ids,
+                mode: modeMap[params.mode || 'onboarding_default'],
+                prompts: params.prompts.map(p => ({
+                    type: promptTypeMap[p.type],
+                    title: p.title,
+                    singleSelect: p.single_select ?? true,
+                    required: p.required ?? false,
+                    inOnboarding: p.in_onboarding ?? true,
+                    options: p.options.map(o => {
+                        // Validate that each option has at least one role or channel
+                        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 {
+                            title: o.title,
+                            description: o.description,
+                            emoji: o.emoji_id ? { id: o.emoji_id, name: o.emoji_name } : o.emoji_name || undefined,
+                            roles: o.role_ids || [],
+                            channels: o.channel_ids || [],
+                        };
+                    }),
+                })),
+            };
+            const onboarding = await guild.editOnboarding(onboardingData);
+            return {
+                content: [{ type: "text", text: `Onboarding setup complete for "${guild.name}"!\nEnabled: ${onboarding.enabled}\nMode: ${params.mode || 'onboarding_default'}\nDefault Channels: ${params.default_channel_ids.length}\nPrompts: ${onboarding.prompts.size}` }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error setting up onboarding: ${error.message}` }],
+            };
+        }
+    });
+    // ============================================================================
+    // COMMUNITY SETUP TOOLS
+    // ============================================================================
+    server.registerTool("discord_get_community_settings", {
+        title: "Get Community Settings",
+        description: `Get the community settings for a server.
+
+Shows rules channel, updates channel, and other community-related settings.
+
+Args:
+  - guild_id (string): Discord server/guild ID
+  - response_format ('markdown' | 'json'): Output format (default: 'json')
+
+Returns:
+  Community settings including channels and features`,
+        inputSchema: GetCommunitySettingsSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await getClient();
+            const guild = client.guilds.cache.get(params.guild_id);
+            if (!guild) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Guild not found: ${params.guild_id}` }],
+                };
+            }
+            const isCommunity = guild.features.includes('COMMUNITY');
+            const settings = {
+                isCommunity,
+                features: guild.features,
+                rulesChannelId: guild.rulesChannelId,
+                publicUpdatesChannelId: guild.publicUpdatesChannelId,
+                safetyAlertsChannelId: guild.safetyAlertsChannelId,
+                systemChannelId: guild.systemChannelId,
+                description: guild.description,
+                preferredLocale: guild.preferredLocale,
+                premiumTier: guild.premiumTier,
+                premiumSubscriptionCount: guild.premiumSubscriptionCount,
+                vanityURLCode: guild.vanityURLCode,
+            };
+            const text = formatResponse(settings, params.response_format, (data) => {
+                let output = `**Community Settings for ${guild.name}**\n`;
+                output += `Community Enabled: ${data.isCommunity ? 'Yes' : 'No'}\n\n`;
+                output += `**Channels:**\n`;
+                output += `- Rules: ${data.rulesChannelId ? `<#${data.rulesChannelId}>` : 'Not set'}\n`;
+                output += `- Public Updates: ${data.publicUpdatesChannelId ? `<#${data.publicUpdatesChannelId}>` : 'Not set'}\n`;
+                output += `- Safety Alerts: ${data.safetyAlertsChannelId ? `<#${data.safetyAlertsChannelId}>` : 'Not set'}\n`;
+                output += `- System: ${data.systemChannelId ? `<#${data.systemChannelId}>` : 'Not set'}\n\n`;
+                output += `**Server Info:**\n`;
+                output += `- Description: ${data.description || 'None'}\n`;
+                output += `- Locale: ${data.preferredLocale}\n`;
+                output += `- Boost Level: ${data.premiumTier} (${data.premiumSubscriptionCount} boosts)\n`;
+                output += `- Vanity URL: ${data.vanityURLCode || 'None'}\n\n`;
+                output += `**Features:** ${data.features.join(', ')}`;
+                return output;
+            });
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error getting community settings: ${error.message}` }],
+            };
+        }
+    });
+    server.registerTool("discord_setup_community", {
+        title: "Setup Community Server",
+        description: `Configure the required channels for a Community server.
+
+Sets the rules channel and public updates channel which are required for Community features.
+The server must already have Community enabled in Discord Server Settings.
+
+Args:
+  - guild_id (string): Discord server/guild ID
+  - rules_channel_id (string): Channel for server rules (required)
+  - public_updates_channel_id (string): Channel for Discord updates (required)
+  - description (string, optional): Server description (max 120 chars)
+  - preferred_locale (string, optional): Preferred language (e.g., 'en-US', 'de')
+  - safety_alerts_channel_id (string, optional): Channel for safety alerts
+
+Returns:
+  Updated community settings`,
+        inputSchema: SetupCommunitySchema,
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            const client = await getClient();
+            const guild = client.guilds.cache.get(params.guild_id);
+            if (!guild) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `Guild not found: ${params.guild_id}` }],
+                };
+            }
+            const updateData = {
+                rulesChannel: params.rules_channel_id,
+                publicUpdatesChannel: params.public_updates_channel_id,
+            };
+            if (params.description !== undefined) {
+                updateData.description = params.description;
+            }
+            if (params.preferred_locale !== undefined) {
+                updateData.preferredLocale = params.preferred_locale;
+            }
+            if (params.safety_alerts_channel_id !== undefined) {
+                updateData.safetyAlertsChannel = params.safety_alerts_channel_id;
+            }
+            const updated = await guild.edit(updateData);
+            const isCommunity = updated.features.includes('COMMUNITY');
+            return {
+                content: [{ type: "text", text: `Community settings updated for "${updated.name}"!\nCommunity Enabled: ${isCommunity ? 'Yes' : 'No'}\nRules Channel: <#${params.rules_channel_id}>\nPublic Updates: <#${params.public_updates_channel_id}>${params.description ? `\nDescription: ${params.description}` : ''}` }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `Error setting up community: ${error.message}` }],
+            };
+        }
+    });
 }

package/dist/types.d.ts

@@ -1,3 +1,12 @@
+export interface ForumTag {
+    id: string;
+    name: string;
+    moderated: boolean;
+    emoji: {
+        id: string | null;
+        name: string | null;
+    } | null;
+}
 export interface DiscordChannel {
     id: string;
     name: string;
@@ -6,6 +15,13 @@ export interface DiscordChannel {
     position?: number;
     parentId?: string;
     parentName?: string;
+    availableTags?: ForumTag[];
+    defaultReactionEmoji?: {
+        id: string | null;
+        name: string | null;
+    } | null;
+    defaultSortOrder?: number | null;
+    defaultForumLayout?: number | null;
 }
 export interface DiscordGuild {
     id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mahesvara/discord-mcpserver",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "MCP server for controlling Discord servers via bot token",
   "author": "Mahesvara",
   "repository": {
@@ -27,7 +27,7 @@
   },
   "main": "dist/index.js",
   "bin": {
-    "discord-mcp-server": "dist/index.js"
+    "discord-mcpserver": "dist/index.js"
   },
   "files": [
     "dist",