Nika — Discord MCP Server

A comprehensive Model Context Protocol server that lets AI assistants run a Discord community: messaging, moderation, roles, channels, forums, webhooks, invites, scheduled events, AutoMod, onboarding, emojis/stickers, permission overwrites, voice management — 111 tools, plus a raw REST passthrough (discord_api_request) so anything the Discord API can do is reachable.

Built with Python + discord.py (persistent gateway connection) and FastMCP.

Setup

1. Create the Discord bot (done)

Application: Nika (ID 1538805149865091092)
Enabled intents: Server Members, Message Content
Token: stored in .env (never commit it — .gitignore protects it)

2. Invite the bot to your server

Open this URL and pick your server (grant Administrator for full functionality):

https://discord.com/api/oauth2/authorize?client_id=1538805149865091092&permissions=8&scope=bot%20applications.commands

⚠️ The bot must be in a server before most tools can do anything.

3. Install & configure

python -m venv .venv
.venv\Scripts\pip install -e ".[dev]"

.env (already created):

DISCORD_TOKEN=...            # bot token
DISCORD_GUILD_ID=            # optional: default server id → makes guildId optional everywhere
MCP_TRANSPORT=stdio          # stdio | http
HTTP_HOST=0.0.0.0            # HTTP mode only
HTTP_PORT=8085
LOG_LEVEL=INFO

Usage

stdio (default — Claude Desktop, VS Code, Cursor, etc.)

.venv\Scripts\python -m discord_mcp

Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "nika": {
      "command": "d:\\Projects\\david\\DiscordMCP\\.venv\\Scripts\\python.exe",
      "args": ["-m", "discord_mcp"],
      "cwd": "d:\\Projects\\david\\DiscordMCP"
    }
  }
}

HTTP (streamable) — remote access, n8n, multi-client

.venv\Scripts\python -m discord_mcp --transport http --port 8085
# endpoint: http://localhost:8085/mcp

Client config:

{
  "mcpServers": {
    "nika": { "url": "http://localhost:8085/mcp" }
  }
}

Docker

docker compose up -d            # builds + runs HTTP mode on :8085
docker run -i --rm -e DISCORD_TOKEN=$env:DISCORD_TOKEN discord-mcp:latest   # stdio

Testing with the MCP Inspector

npx @modelcontextprotocol/inspector .venv\Scripts\python.exe -m discord_mcp

Tool reference (111 tools)

Area	Tools
Servers	`list_servers`, `get_server_info`, `get_server_summary`, `modify_server`, `leave_server`
Channels	`list_channels`, `list_categories`, `find_channel`, `get_channel_info`, `create_text_channel`, `create_voice_channel`, `create_stage_channel`, `create_category`, `create_forum_channel`, `edit_channel`, `move_channel`, `clone_channel`, `delete_channel`, `create_thread`, `list_active_threads`, `list_channel_threads`
Messages	`send_message` (embeds + files + reply), `reply_to_message`, `edit_message`, `delete_message`, `bulk_delete_messages`, `read_messages` (before/after/around), `get_message`, `pin_message`, `unpin_message`, `list_pinned_messages`, `add_reaction`, `add_multiple_reactions`, `remove_reaction`, `clear_reactions`
Members	`get_member_info`, `find_user` (by name/nick → ping), `list_members`, `set_nickname`, `get_user_by_id`
Roles	`list_roles`, `create_role`, `edit_role`, `delete_role`, `assign_role`, `remove_role`, `get_user_roles`
DMs	`send_private_message`, `edit_private_message`, `delete_private_message`, `read_private_messages`
Moderation	`kick_member`, `ban_member`, `unban_member`, `get_bans`, `timeout_member`, `remove_timeout`, `prune_members` (dry-run safe)
Voice	`move_member`, `disconnect_member`, `modify_voice_state` (mute/deafen/suppress), `get_voice_channel_members`, `list_voice_channels`
Events	`create_scheduled_event`, `edit_scheduled_event`, `delete_scheduled_event`, `list_scheduled_events`, `get_scheduled_event`, `get_scheduled_event_users`
Permissions	`list_channel_permission_overwrites`, `upsert_role_channel_permissions`, `upsert_member_channel_permissions`, `delete_channel_permission_overwrite`
Invites	`create_invite`, `list_invites`, `delete_invite`, `get_invite_details`
Webhooks	`create_webhook`, `edit_webhook`, `delete_webhook`, `list_webhooks`, `send_webhook_message`
Forums	`list_forum_channels`, `get_forum_channel_info`, `list_forum_tags`, `add_forum_tag`, `edit_forum_tag`, `delete_forum_tag`, `create_forum_post`, `reply_to_forum_post`, `list_forum_posts`, `modify_forum_post`, `delete_forum_post`
Emojis & Stickers	`list_emojis`, `get_emoji_details`, `create_emoji`, `edit_emoji`, `delete_emoji`, `list_stickers`, `create_sticker`, `edit_sticker`, `delete_sticker`
AutoMod	`list_automod_rules`, `create_automod_rule` (keywords/regex/presets/mention-spam), `edit_automod_rule`, `delete_automod_rule`
Onboarding & Audit	`get_welcome_screen`, `modify_welcome_screen`, `get_onboarding`, `search_audit_log`
Raw API	`discord_api_request` — any endpoint, any method (PUT/PATCH/DELETE need `confirmDestructive=true`), respects rate limits

Design notes

Hybrid gateway + REST: one persistent discord.py gateway connection provides live state (member/channel lookups, names→IDs) while mutations go through the same client. Tool calls bridge onto the gateway loop via asyncio.run_coroutine_threadsafe.
Safety: the raw tool requires confirmDestructive=true for mutating methods; prune_members defaults to a dry run; destructive tools accept a reason which is written to the audit log.
Optional guildId: set DISCORD_GUILD_ID in .env and every guildId parameter becomes optional.
Errors: Discord errors are converted to readable messages (e.g. Missing permissions: ...).

Limitations

Requires a bot token (user-token/self-bot automation violates Discord ToS).
Message reading requires the bot to see the channel and (for content) the Message Content intent.
No voice audio streaming/receiving.

Development

.venv\Scripts\python -m pytest        # 22 unit tests

Layout: discord_mcp/bot.py (gateway bridge) · discord_mcp/server.py (FastMCP) · discord_mcp/tools/*.py (one module per domain) · discord_mcp/utils/ (serializers, embeds).

License

MIT

Nika