Skip to main content
Glama
berkal749

mcp-discord-mod

by berkal749

mcp-discord-mod

A lightweight Model Context Protocol server for Discord server moderation. Built with discord.js v14 and TypeScript.

Focused on what matters: kick, ban, timeout, roles, channels, audit logs, and member management. No bloat.

Setup

1. Create a Discord Bot

  1. Go to Discord Developer Portal

  2. Create a new application → Bot

  3. Under Privileged Gateway Intents, enable:

    • Server Members Intent

    • Message Content Intent

  4. Copy the bot token

2. Install

git clone https://github.com/YOUR_USERNAME/mcp-discord-mod.git
cd mcp-discord-mod
npm install
npm run build

3. Configure

Set your bot token as an environment variable:

export DISCORD_TOKEN="your_bot_token_here"

Or create a .env file:

DISCORD_TOKEN=your_bot_token_here

4. Add to your MCP client

Add to your MCP config (e.g. opencode.json, claude_desktop_config.json, etc.):

{
  "discord-mod": {
    "type": "local",
    "command": ["node", "/path/to/mcp-discord-mod/build/index.js"],
    "env": {
      "DISCORD_TOKEN": "your_bot_token_here"
    }
  }
}

Related MCP server: Discord MCP Server

Tools

Tool

Description

discord_mod_login

Login to Discord (auto-logins if DISCORD_TOKEN is set)

discord_mod_kick_member

Kick a member from a server

discord_mod_ban_member

Ban a member (optionally delete recent messages)

discord_mod_unban_member

Unban a user

discord_mod_timeout_member

Timeout (mute) a member for a duration

discord_mod_warn_member

Send a warning DM to a member

discord_mod_list_bans

List all banned users

discord_mod_set_nickname

Set or clear a member's nickname

discord_mod_list_roles

List all roles in a server

discord_mod_create_role

Create a new role

discord_mod_edit_role

Edit role properties

discord_mod_delete_role

Delete a role

discord_mod_assign_role

Assign a role to a member

discord_mod_remove_role

Remove a role from a member

discord_mod_create_category

Create a channel category

discord_mod_create_channel

Create a text or voice channel

discord_mod_delete_channel

Delete a channel

discord_mod_edit_channel

Edit channel name, topic, slowmode

discord_mod_set_permissions

Set role/user permissions on a channel

discord_mod_remove_permissions

Remove permission overrides

discord_mod_list_members

List server members

discord_mod_get_member

Get detailed member info

discord_mod_list_servers

List all bot servers

discord_mod_get_server_info

Get server details and channels

discord_mod_get_audit_log

View the server audit log

discord_mod_send_dm

Send a direct message to a user

discord_mod_purge_messages

Bulk delete messages with filters

discord_mod_bulk_delete_messages

Delete up to 100 messages by ID

discord_mod_pin_message

Pin a message

discord_mod_unpin_message

Unpin a message

Bot Permissions

Your bot needs these permissions in the server:

  • Kick Members

  • Ban Members

  • Moderate Members (for timeouts)

  • Manage Roles

  • Manage Channels

  • View Audit Log

  • Send Messages

  • Read Message History

  • Manage Messages (for purge)

License

MIT

Install Server
A
license - permissive license
B
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    Enables comprehensive Discord bot management and server operations through MCP, including channel management, message handling, member moderation, role management, and voice operations. Provides secure Discord API integration with built-in permission controls and audit logging capabilities.
    19
    230
    18
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    Enables Discord bot integration through MCP, allowing users to manage servers, channels, roles, members, and messages including moderation actions like bans, timeouts, and bulk deletions through natural language.
    33
    MIT
  • F
    license
    -
    quality
    C
    maintenance
    Comprehensive Discord server management through MCP, enabling channel, role, permission, message, moderation, and automation tasks via natural language.
    4

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/berkal749/mcp-discord-mod'

If you have feedback or need assistance with the MCP directory API, please join our Discord server