Skip to content

Conversation

@aj-geddes
Copy link

Discord Agent MCP Server

Production-ready MCP server for comprehensive Discord automation and management through AI assistants.

Overview

This submission adds a Discord integration MCP server with 46+ tools covering all major Discord API operations:

  • 10 Messaging Tools: Send, edit, delete messages, manage reactions and pins
  • 10 Channel Tools: Create and manage text, voice, forum, and stage channels
  • 3 Thread Tools: Create, find, and archive forum threads
  • 6 Server Tools: Server info, webhooks, invites, audit logs
  • 3 Member Tools: Member management and information
  • 6 Role Tools: Complete role management system
  • 5 Moderation Tools: Kick, ban, timeout capabilities

Technical Details

  • Repository: https://github.com/aj-geddes/discord-agent-mcp
  • Category: communication
  • License: MIT
  • Built with: Discord.js v14, TypeScript, Docker
  • Transport modes: HTTP (default) and STDIO
  • Docker image: Multi-stage build with non-root user and health checks

Configuration

Requires one environment variable:

  • DISCORD_TOKEN (required, secret): Discord bot token from Developer Portal

Optional configuration:

  • TRANSPORT_MODE: http or stdio (default: http)
  • HTTP_PORT: Server port (default: 3000)
  • LOG_LEVEL: debug, info, warn, error (default: info)
  • LOG_FORMAT: json or pretty (default: json)

User Setup Requirements

Users need to:

  1. Create a Discord bot at Discord Developer Portal
  2. Enable Privileged Gateway Intents:
    • Server Members Intent ✅
    • Message Content Intent ✅
  3. Invite bot to their server with appropriate permissions
  4. Copy bot token for DISCORD_TOKEN configuration

Validation Note

The MCP server requires a valid DISCORD_TOKEN to initialize and connect to Discord. The tools.json file is provided for catalog validation purposes, listing all 46 available tools that the server exposes once properly configured.

Use Cases

  • Community Management: Automated welcome messages, role assignments, channel creation
  • Content Moderation: AI-assisted moderation with timeout, kick, and ban capabilities
  • Server Organization: Manage channels, categories, and forum threads
  • Event Management: Create stage channels, manage voice channels, send invites
  • Member Support: Answer questions, provide information, assign roles

Testing

The server has been:

  • ✅ Successfully deployed in production Kubernetes environment (K3d)
  • ✅ Tested with all 46 tools functioning correctly
  • ✅ Docker build verified (multi-stage build with security best practices)
  • ✅ MCP protocol compliance validated
  • ✅ package-lock.json included for reproducible builds

Files Included

  • server.yaml: MCP catalog configuration
  • tools.json: Complete tool listing (46 tools)
  • readme.md: User-facing documentation with setup instructions

Let me know if you need any additional information or changes to the submission!

Production-ready MCP server for AI-assisted Discord management and automation with 46+ tools:

**Messaging Tools (10)**
- send_message, send_rich_message, send_message_with_file
- read_messages, edit_message, delete_message, bulk_delete_messages
- add_reaction, pin_message, unpin_message

**Channel Management (10)**
- list_channels, get_channel_details
- create_text_channel, create_voice_channel, create_forum_channel
- create_category, create_stage_channel
- modify_channel, delete_channel, set_channel_permissions

**Thread Management (3)**
- find_threads, create_thread, archive_thread

**Server Management (6)**
- get_server_info, modify_server, get_audit_logs
- list_webhooks, create_webhook, get_invites, create_invite

**Member Management (3)**
- get_member_info, list_members, set_nickname

**Role Management (6)**
- assign_role, remove_role
- create_role, delete_role, modify_role
- list_roles, get_role_info

**Moderation (5)**
- kick_member, ban_member, unban_member
- timeout_member, remove_timeout, get_bans

**Technical Details**
- Category: communication
- License: MIT
- Built with: Discord.js v14, TypeScript, Docker
- Transport: HTTP (default) and STDIO modes
- Homepage: https://github.com/aj-geddes/discord-agent-mcp

**Prerequisites**
Requires DISCORD_TOKEN environment variable (marked as secret in server.yaml).
Users need to create a Discord bot at the Developer Portal with:
- Server Members Intent enabled
- Message Content Intent enabled
- Appropriate bot permissions

**Validation Note**
The server requires a valid Discord bot token to initialize and connect to Discord.
tools.json is provided for catalog validation without requiring a live Discord connection.
@aj-geddes aj-geddes requested a review from a team as a code owner October 22, 2025 15:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant