TheFinalDiscordMCP

Eye of Sauron is an MCP-enabled Discord bot that combines AI chat, voice TTS, WoWS stats, moderation, and powerful MCP tooling to let AI assistants control Discord workflows. It provides a single, end-to-end runtime you can deploy and connect to your preferred MCP client for automated, context-aware interactions in your server.

How to use

You run the MCP-enabled Discord bot in a local or remote environment and connect it to an MCP client. The bot exposes controls for AI chat, voice, WoWS lookups, moderation, channel and role management, and a suite of MCP endpoints that let AI assistants drive actions in your Discord server. To begin, ensure your MCP client is configured to target the correct MCP server (the one named discord) and that you supply the required environment variables so the bot can authenticate with Discord and access the AI services.

How to install

npm install

# Start in standard mode
MCP_HTTP_PORT=3001 npm start

# Start in API-only mode (no Discord bot)
HTTP_ONLY=true MCP_HTTP_PORT=3001 npm start

# Development with hot reload
npm run dev

Additional configuration and usage notes

Configure your environment with the required tokens and IDs so the bot can connect to Discord and access AI features. The following environment variables are used in MCP mode:

DISCORD_TOKEN: Your Discord bot token. DISCORD_GUILD_ID: Your server ID. OPENROUTER_API_KEY: Optional key for AI features. BOT_CREATOR_ID/BOT_CREATOR_NAME: Optional creator details used for voice command prioritization. OPENROUTER_MODEL: Optional override for the AI model. MCP_HTTP_PORT: Port for HTTP API. HTTP_ONLY: Run API-only without the Discord bot.

Security and creator mode

Creator mode locks voice commands to a specific user to prevent others from controlling voice features. Set BOT_CREATOR_ID in your environment, then use !lockvoice to enable creator-only voice control. Use !unlockvoice to restore normal access.

Troubleshooting tips

If you don’t see the bot online, verify your DISCORD_TOKEN is correct and that the bot has the necessary Privileged Gateway Intents enabled in the Discord Developer Portal. Check the MCP port (default 3001) is reachable if you’re using the HTTP API. Review logs for any authentication or API key issues with OpenRouter.

Examples of MCP usage with this server

In MCP client configurations, you can point to the local HTTP API at http://localhost:3001/mcp or to the stdio entry that runs node with the compiled index. The Discord bot exposes multiple endpoints and commands you can trigger from your MCP client to perform AI chat, WoWS lookups, or channel management actions.

Available tools

AI Chat

Interact with users via AI-powered chat using multiple AI models connected through OpenRouter.

Voice TTS

Convert text to speech using a range of neural voices for live or DM audio.

WoWS Stats

Look up World of Warships player stats and clan information via the Wargaming API.

Moderation

Ban, kick, timeout, and bulk delete messages to manage your server.

Server Management

Create channels, roles, and categories to organize your Discord server.

MCP Integration

Operate 93 MCP tools to control and automate AI assistants within Discord.

HTTP API

Optional REST API mode for web integrations and external tooling.

DM Support

Automatic AI responses in direct messages with no prefix required.