# discord-node-mcp [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/Oratorian/discord-node-mcp  
**GitHub Stars:** 0  
**npm Downloads (last month):** 317  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/discord-node-mcp

## Description
MCP server for controlling Discord servers via bot token

## Tools
Capabilities this server exposes over MCP:

- **discord_list_guilds** — List all Discord servers (guilds) the bot has access to.

Returns server names, IDs, member counts, and owner information.

Args:
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of guilds with id, name, memberCount, icon, ownerId
- **discord_get_guild** — Get detailed information about a specific Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Server details including name, member count, owner, and icon
- **discord_leave_guild** — Leave a Discord server (guild). The bot will no longer have access to this server.

WARNING: This is a destructive action. The bot will need to be re-invited to rejoin.

Args:
  - guild_id (string): Discord server/guild ID to leave
  - confirm (boolean): Must be set to true to confirm leaving

Returns:
  Confirmation message with server details
- **discord_edit_guild** — Edit server settings like name, verification level, and system channel.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string, optional): New server name
  - verification_level (string, optional): 'none', 'low', 'medium', 'high', 'very_high'
  - default_notifications (string, optional): 'all_messages' or 'only_mentions'
  - afk_channel_id (string, optional): AFK voice channel ID
  - afk_timeout (number, optional): AFK timeout in seconds
  - system_channel_id (string, optional): System messages channel
  - system_channel_flags (object, optional): System channel behavior

Returns:
  Updated server details
- **discord_list_channels** — List channels in a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - type ('text' | 'voice' | 'category' | 'all'): Filter by channel type (default: 'all')
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of channels with id, name, type, topic, and category info
- **discord_get_channel** — Get detailed information about a specific channel.

Args:
  - channel_id (string): Discord channel ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Channel details including name, type, topic, and category
- **discord_create_channel** — Create a new channel or category in a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string): Channel name
  - 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/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
  - 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
- **discord_delete_channel** — Delete a channel from a Discord server. This action is permanent!

Args:
  - channel_id (string): Discord channel ID to delete

Returns:
  Confirmation of deletion
- **discord_edit_channel** — Edit a channel's properties including name, topic, category, position, and more.

Args:
  - channel_id (string): Discord channel ID
  - name (string, optional): New channel name
  - topic (string, optional): New channel topic
  - parent_id (string, optional): Move to a different category (or 'none' to remove from category)
  - position (number, optional): New position of the channel
  - 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
  - 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
- **discord_set_channel_permissions** — Set permission overrides for a role or member on a channel.

Common permission names:
- View: ViewChannel
- Messages: SendMessages, ReadMessageHistory, ManageMessages, EmbedLinks, AttachFiles, AddReactions
- Voice: Connect, Speak, Stream, MuteMembers, DeafenMembers, MoveMembers
- Threads: CreatePublicThreads, CreatePrivateThreads, SendMessagesInThreads
- Management: ManageChannels, ManageRoles, ManageWebhooks

Args:
  - channel_id (string): Discord channel ID
  - target_id (string): Role or User ID to set permissions for
  - target_type ('role' | 'member'): Whether target is a role or member
  - allow (string[], optional): Permissions to allow (e.g., ['ViewChannel', 'SendMessages'])
  - deny (string[], optional): Permissions to deny (e.g., ['SendMessages'])

Returns:
  Confirmation of permission changes
- **discord_remove_channel_permissions** — Remove all permission overrides for a role or member on a channel.

Args:
  - channel_id (string): Discord channel ID
  - target_id (string): Role or User ID to remove permission overrides for

Returns:
  Confirmation of removal
- **discord_get_channel_permissions** — Get all permission overrides for a channel.

Args:
  - channel_id (string): Discord channel ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of permission overrides with allow/deny for each role/member
- **discord_sync_channel_permissions** — Sync a channel's permissions with its parent category.

Args:
  - channel_id (string): Discord channel ID

Returns:
  Confirmation of sync
- **discord_send_message** — Send a message to a Discord channel.

Args:
  - channel_id (string): Discord channel ID
  - content (string): Message content (max 2000 characters)
  - reply_to (string, optional): Message ID to reply to

Returns:
  The sent message details including ID
- **discord_get_messages** — Retrieve messages from a Discord channel.

Args:
  - channel_id (string): Discord channel ID
  - limit (number): Number of messages to retrieve (1-100, default: 20)
  - before (string, optional): Get messages before this message ID
  - after (string, optional): Get messages after this message ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of messages with content, author, timestamp, attachments
- **discord_delete_message** — Delete a message from a Discord channel.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID to delete

Returns:
  Confirmation of deletion
- **discord_edit_message** — Edit a message sent by the bot.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID to edit
  - content (string): New message content (max 2000 characters)

Returns:
  Confirmation of edit
- **discord_add_reaction** — Add an emoji reaction to a message.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID to react to
  - emoji (string): Emoji to react with (e.g., '👍' or custom emoji format)

Returns:
  Confirmation of reaction added
- **discord_remove_reaction** — Remove the bot's emoji reaction from a message.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID
  - emoji (string): Emoji to remove

Returns:
  Confirmation of reaction removed
- **discord_pin_message** — Pin a message in a channel.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID to pin

Returns:
  Confirmation of message pinned
- **discord_unpin_message** — Unpin a message in a channel.

Args:
  - channel_id (string): Discord channel ID
  - message_id (string): Message ID to unpin

Returns:
  Confirmation of message unpinned
- **discord_get_pinned_messages** — Get all pinned messages in a channel.

Args:
  - channel_id (string): Discord channel ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of pinned messages
- **discord_list_members** — List members in a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - limit (number): Maximum number of members (1-100, default: 20)
  - after (string, optional): Get members after this user ID (for pagination)
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of members with username, nickname, roles, join date
- **discord_get_member** — Get detailed information about a specific member.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Member details including username, nickname, roles, join date
- **discord_move_member** — Move a member to a different voice channel or disconnect them from voice.

The member must currently be connected to a voice channel to be moved.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID to move
  - channel_id (string | null): Target voice channel ID, or null to disconnect

Returns:
  Confirmation of move or disconnect
- **discord_set_nickname** — Set or clear a member's nickname.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID
  - nickname (string, optional): New nickname (empty/null to reset)

Returns:
  Confirmation of nickname change
- **discord_list_roles** — List all roles in a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of roles with name, color, position, permissions
- **discord_add_role** — Add a role to a Discord member.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID
  - role_id (string): Discord role ID to add

Returns:
  Confirmation of role added
- **discord_remove_role** — Remove a role from a Discord member.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID
  - role_id (string): Discord role ID to remove

Returns:
  Confirmation of role removed
- **discord_create_role** — Create a new role in a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string): Role name
  - color (number, optional): Role color as decimal integer (e.g., 16711680 for red)
  - mentionable (boolean): Whether the role can be mentioned (default: false)
  - hoist (boolean): Whether to display role members separately (default: false)

Returns:
  The created role's details
- **discord_delete_role** — Delete a role from a Discord server. This action is permanent!

Args:
  - guild_id (string): Discord server/guild ID
  - role_id (string): Discord role ID to delete

Returns:
  Confirmation of deletion
- **discord_edit_role** — Edit a role's properties including name, color, and permissions.

Common permission names:
- Admin: Administrator (grants all permissions)
- General: ManageGuild, ManageRoles, ManageChannels, KickMembers, BanMembers, ModerateMembers
- Messages: SendMessages, ManageMessages, EmbedLinks, AttachFiles, ReadMessageHistory, MentionEveryone
- Voice: Connect, Speak, MuteMembers, DeafenMembers, MoveMembers, Stream
- Other: ManageEmojisAndStickers, ManageWebhooks, ManageEvents, ViewAuditLog

Args:
  - guild_id (string): Discord server/guild ID
  - role_id (string): Discord role ID to edit
  - name (string, optional): New role name
  - color (number, optional): Role color as decimal integer (e.g., 16711680 for red)
  - mentionable (boolean, optional): Whether the role can be mentioned
  - hoist (boolean, optional): Whether to display role members separately
  - permissions (string[], optional): Permissions to grant (replaces existing). Examples: ['SendMessages', 'ViewChannel']

Returns:
  Updated role details
- **discord_set_role_positions** — Reorder role hierarchy by setting role positions.

Higher position = more authority in the hierarchy. The @everyone role is always at position 0.
Roles can only manage other roles below them in the hierarchy.

IMPORTANT: The bot can only move roles that are below its own highest role in the hierarchy.

Args:
  - guild_id (string): Discord server/guild ID
  - positions (array): Array of objects with:
    - role_id (string): Discord role ID
    - position (number): New position for the role (higher = more authority)

Returns:
  Confirmation of position changes
- **discord_kick_member** — Kick a member from a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID to kick
  - reason (string, optional): Reason for kick (visible in audit log)

Returns:
  Confirmation of kick
- **discord_ban_member** — Ban a member from a Discord server.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID to ban
  - reason (string, optional): Reason for ban (visible in audit log)
  - delete_message_days (number): Days of messages to delete (0-7, default: 0)

Returns:
  Confirmation of ban
- **discord_unban_member** — Remove a ban from a user.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID to unban

Returns:
  Confirmation of unban
- **discord_timeout_member** — Timeout (mute) a member for a specified duration. They cannot send messages, react, or join voice.

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string): Discord user ID to timeout
  - duration_minutes (number): Timeout duration in minutes (0 to remove, max 40320 = 28 days)
  - reason (string, optional): Reason for timeout (visible in audit log)

Returns:
  Confirmation of timeout
- **discord_list_bans** — List all banned users in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - limit (number): Number of bans to return (1-1000, default 100)
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of banned users with reasons
- **discord_prune_members** — Remove inactive members from the server.

Args:
  - guild_id (string): Discord server/guild ID
  - days (number): Days of inactivity required (1-30)
  - include_roles (string[], optional): Role IDs to include in prune (by default only members without roles)
  - dry_run (boolean): If true, returns count without actually pruning (default true)

Returns:
  Number of members pruned (or would be pruned if dry_run)
- **discord_get_audit_log** — Get the audit log for a server. Shows who did what actions.

Common action types:
1=GuildUpdate, 10=ChannelCreate, 11=ChannelUpdate, 12=ChannelDelete,
20=MemberKick, 22=MemberBanAdd, 23=MemberBanRemove, 24=MemberUpdate, 25=MemberRoleUpdate,
30=RoleCreate, 31=RoleUpdate, 32=RoleDelete,
72=MessageDelete, 73=MessageBulkDelete

Args:
  - guild_id (string): Discord server/guild ID
  - user_id (string, optional): Filter by user who performed action
  - action_type (number, optional): Filter by action type
  - limit (number): Number of entries (1-100, default 20)
  - response_format ('json' | 'markdown'): Output format

Returns:
  Audit log entries with action, user, target, and changes
- **discord_list_automod_rules** — List all auto moderation rules for a server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  List of auto moderation rules
- **discord_get_automod_rule** — Get details of a specific auto moderation rule.

Args:
  - guild_id (string): Discord server/guild ID
  - rule_id (string): Auto moderation rule ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Auto moderation rule details
- **discord_create_automod_rule** — Create a new auto moderation rule for a server.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string): Rule name
  - event_type ('message_send'): Event that triggers the rule
  - trigger_type ('keyword' | 'spam' | 'keyword_preset' | 'mention_spam'): Trigger type
  - trigger_metadata (object, optional): Trigger configuration (keyword_filter, presets, etc.)
  - actions (array): Actions to take (block_message, send_alert_message, timeout)
  - enabled (boolean): Whether rule is enabled (default: true)
  - exempt_roles (array, optional): Role IDs exempt from this rule
  - exempt_channels (array, optional): Channel IDs exempt from this rule

Returns:
  Created rule details
- **discord_edit_automod_rule** — Edit an existing auto moderation rule.

Args:
  - guild_id (string): Discord server/guild ID
  - rule_id (string): Auto moderation rule ID
  - name (string, optional): New rule name
  - trigger_metadata (object, optional): New trigger configuration
  - actions (array, optional): New actions
  - enabled (boolean, optional): Enable/disable rule
  - exempt_roles (array, optional): New exempt roles
  - exempt_channels (array, optional): New exempt channels

Returns:
  Updated rule details
- **discord_delete_automod_rule** — Delete an auto moderation rule from a server.

Args:
  - guild_id (string): Discord server/guild ID
  - rule_id (string): Auto moderation rule ID to delete

Returns:
  Confirmation of deletion
- **discord_list_emojis** — List all custom emojis in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of emojis with name, ID, and whether animated
- **discord_create_emoji** — Create a custom emoji in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string): Emoji name (2-32 chars, alphanumeric and underscores)
  - image_url (string): URL of image (PNG, JPG, GIF under 256KB)
  - roles (string[], optional): Role IDs that can use this emoji

Returns:
  Created emoji details
- **discord_delete_emoji** — Delete a custom emoji from a server.

Args:
  - guild_id (string): Discord server/guild ID
  - emoji_id (string): Discord emoji ID

Returns:
  Confirmation of deletion
- **discord_list_stickers** — List all custom stickers in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of stickers with name, description, and format
- **discord_delete_sticker** — Delete a custom sticker from a server.

Args:
  - guild_id (string): Discord server/guild ID
  - sticker_id (string): Discord sticker ID

Returns:
  Confirmation of deletion
- **discord_list_webhooks** — List webhooks in a guild or channel.

Args:
  - guild_id (string, optional): List all webhooks in the server
  - channel_id (string, optional): List webhooks for a specific channel
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of webhooks with name, channel, and URL
- **discord_create_webhook** — Create a webhook in a channel.

Args:
  - channel_id (string): Discord channel ID
  - name (string): Webhook name
  - avatar_url (string, optional): Avatar image URL

Returns:
  Created webhook details including URL
- **discord_edit_webhook** — Edit an existing webhook.

Args:
  - webhook_id (string): Discord webhook ID
  - name (string, optional): New webhook name
  - channel_id (string, optional): Move webhook to different channel

Returns:
  Updated webhook details
- **discord_delete_webhook** — Delete a webhook.

Args:
  - webhook_id (string): Discord webhook ID

Returns:
  Confirmation of deletion
- **discord_list_invites** — List all active invites in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of invites with code, uses, max uses, expiration
- **discord_create_invite** — Create an invite link for a channel.

Args:
  - channel_id (string): Discord channel ID
  - max_age (number): Duration in seconds (0 = never expires, max 604800 = 7 days)
  - max_uses (number): Max uses (0 = unlimited)
  - temporary (boolean): Kick members when they disconnect if not assigned a role
  - unique (boolean): Create new unique invite vs reuse existing

Returns:
  Created invite URL
- **discord_delete_invite** — Delete an invite by its code.

Args:
  - invite_code (string): The invite code to delete

Returns:
  Confirmation of deletion
- **discord_list_events** — List all scheduled events in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('json' | 'markdown'): Output format

Returns:
  List of events with name, time, location, and status
- **discord_create_event** — Create a scheduled event in a server.

Args:
  - guild_id (string): Discord server/guild ID
  - name (string): Event name
  - description (string, optional): Event description
  - scheduled_start_time (string): ISO8601 timestamp for start
  - scheduled_end_time (string, optional): ISO8601 timestamp for end
  - entity_type ('stage' | 'voice' | 'external'): Type of event
  - channel_id (string, optional): Channel ID for stage/voice events
  - location (string, optional): Location for external events

Returns:
  Created event details
- **discord_delete_event** — Delete a scheduled event from a server.

Args:
  - guild_id (string): Discord server/guild ID
  - event_id (string): Discord scheduled event ID

Returns:
  Confirmation of deletion
- **discord_get_welcome_screen** — Get the welcome screen configuration for a server.

Requires the server to have Community features enabled.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Welcome screen settings including description and channels
- **discord_edit_welcome_screen** — Edit the welcome screen configuration for a server.

Requires the server to have Community features enabled and bot must have MANAGE_GUILD permission.

Args:
  - guild_id (string): Discord server/guild ID
  - enabled (boolean, optional): Enable/disable the welcome screen
  - description (string, optional): Server description (max 140 chars)
  - welcome_channels (array, optional): Up to 5 channels to show (channel_id, description, emoji)

Returns:
  Updated welcome screen settings
- **discord_get_onboarding** — Get the onboarding configuration for a server.

Onboarding guides new members through a questionnaire to customize their experience.

Args:
  - guild_id (string): Discord server/guild ID
  - response_format ('markdown' | 'json'): Output format (default: 'json')

Returns:
  Onboarding settings including prompts, options, and default channels
- **discord_edit_onboarding** — Edit the onboarding configuration for a server.

Configure prompts/questions that new members answer to customize their server experience.
Each prompt can assign roles or show channels based on member selections.

Args:
  - guild_id (string): Discord server/guild ID
  - prompts (array, optional): Onboarding prompts with options
  - default_channel_ids (array, optional): Channels shown to all new members
  - enabled (boolean, optional): Enable/disable onboarding
  - mode ('onboarding_default' | 'onboarding_advanced', optional): Onboarding mode

Returns:
  Updated onboarding configuration
- **discord_setup_onboarding** — 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
- **discord_get_community_settings** — 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
- **discord_setup_community** — 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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "discord-node-mcp": {
    "command": "npx",
    "args": ["-y","@mahesvara/discord-mcpserver"],
    "env": {
      "DISCORD_BOT_TOKEN": "",
      "TRANSPORT": "",
      "PORT": "",
      "HOST": ""
    }
  }
}
```

**Requires environment variables:** `DISCORD_BOT_TOKEN`, `TRANSPORT`, `PORT`, `HOST` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the discord-node-mcp MCP server does

The discord-node-mcp MCP server gives MCP clients access to Discord administration and community-management operations through a bot account. It can inspect available guilds, channels, members, roles, permissions, messages, bans, audit logs, community settings, welcome screens, onboarding configuration, auto-moderation rules, emojis, stickers, invites, webhooks, and scheduled events.

The available operations also include changes to Discord resources. Agents can create, edit, delete, reorder, assign, remove, pin, unpin, react to, or otherwise manage supported objects, depending on the bot’s permissions. Member actions include kicking, banning, unbanning, nickname changes, voice-channel moves, and timeouts. Message editing is limited to messages sent by the bot.

## How it works

The server authenticates to Discord with `DISCORD_BOT_TOKEN` and exposes its Discord operations as MCP tools. With HTTP enabled, the MCP endpoint is available at `/mcp` on the configured host and port.

Discord permissions determine which actions succeed. The bot must be invited with the scopes and permissions needed for the intended operations. Some functionality also depends on enabling Discord’s Server Members Intent and Message Content Intent in the Developer Portal.

## Setup and configuration

Create a Discord application and bot in the Discord Developer Portal, copy its token, enable the required privileged intents, and invite the bot to the target server. The documented installation choices are a global npm package install or running the package through `npx`.

To run the discord-node-mcp MCP server, set `DISCORD_BOT_TOKEN` in the MCP client configuration or a `.env` file. `TRANSPORT` accepts `stdio` or `http` and defaults to `stdio`; `PORT` defaults to `3000`, while `HOST` defaults to `localhost`. HTTP deployments can bind to `0.0.0.0` for remote access, but the material does not describe an authentication layer for that endpoint.

Stdio configurations invoke the installed command or `npx`; HTTP configurations use an MCP URL such as `http://your-server-ip:3000/mcp`.

## Tools and capabilities

The tool groups cover:

- Guild details, settings, membership, bans, pruning, and audit logs
- Channel creation, editing, deletion, listing, forum tags, and permission overrides
- Message retrieval and management, reactions, replies, and pins
- Member, role, nickname, voice-channel, and timeout operations
- Community settings, welcome screens, onboarding, and auto moderation
- Emojis, stickers, invites, webhooks, and scheduled events

Forum-specific operations include forum channel creation, layout and sorting settings, default reaction configuration, and tag management. Community setup tools can configure rules, updates, and safety-alert channels, while onboarding tools can define prompts, default channels, and roles.

## Limitations and notes

The bot’s Discord permissions and enabled gateway intents constrain the available functionality. Administrative actions such as bans, role changes, channel changes, webhook management, and event management require the corresponding Discord permissions. Keep the bot token secret; the setup instructions treat it as sensitive credential data.

Review the bot’s scope and permissions before enabling tools that can modify or remove Discord content.

_Full upstream README: https://allmcps.com/mcp/discord-node-mcp/readme_

