MCP Relay

MCP Relay is an MCP server that connects Claude to a Discord channel to deliver outbound notifications and collect human responses through interactive prompts. Built for developers and automation engineers who need human-in-the-loop workflows inside their communication channels, the server enables an AI agent to communicate directly with team members where they already collaborate. By configuring a custom Discord bot and specifying a channel ID, users can trigger two primary types of messages from Claude: standard notifications and interactive prompts. Notifications transmit titles and text content immediately without pausing execution. In contrast, prompt messages post queries alongside optional action buttons, actively waiting for a team member to click a button or type a text reply in the Discord channel. The server can also enforce custom timeout windows to prevent hanging requests when an operator does not respond. This bi-directional integration lets automated agents ask for execution approvals, query users for missing context, and announce finished tasks or status changes directly inside Discord.

Category: Communication & Messaging

Tags: chat, discord, messaging, notifications

Visit MCP Relay

How to install and configure MCP Relay

1. Go to the Discord Developer Portal, create an application, create a bot, and reset its token. Under Privileged Gateway Intents, enable Message Content Intent, Server Members Intent, and Presence Intent. 2. Under OAuth2 URL Generator, select scopes bot and applications.commands. Select permissions Send Messages, Embed Links, and Read Message History. Open the generated URL to authorize the bot into your server. 3. Enable Developer Mode in Discord settings, right-click the desired channel, and click Copy Channel ID. 4. Add the server entry to your MCP client configuration file: json { "mcpServers": { "discord-relay": { "command": "node", "args": ["/ABSOLUTE/PATH/TO/MCP Relay/build/index.js"], "env": { "DISCORD_TOKEN": "your_bot_token_here", "DISCORD_CHANNEL_ID": "your_channel_id_here" } } } } 5. Replace the file path, token, and channel ID with your absolute project path and credentials, then restart your MCP client.

What you can do with MCP Relay

• Prompt human operators via Discord action buttons to approve or reject automated operations before the assistant executes sensitive tasks. - Send automated progress updates and status alerts to a dedicated Discord channel when long-running workflows or background jobs complete. - Request missing parameters or user input through Discord chat when Claude requires additional details to solve a complex coding task. - Deliver time-sensitive operational choices to a team channel, automatically continuing or failing if no response arrives within the specified timeout.

Key facts

• https://github.com/emiliobool/MCP-Relay
• Communication & Messaging
• chat, discord, messaging, notifications

Part of MCP Servers

What is MCP Relay?

MCP Relay is a Model Context Protocol server that bridges AI assistants like Claude to Discord. It exposes tools allowing the assistant to broadcast status messages and present interactive prompt dialogs with custom buttons or text input fields, receiving responses directly back into the conversation.

How do I install and configure MCP Relay?

You must create a Discord bot in the Discord Developer Portal, grant the required bot intents and permissions, and add it to your server. Next, copy your bot token and channel ID into your MCP client configuration under the discord-relay definition, pointing the node command to the local build file.

Which message types does MCP Relay support?

The server supports two message types via its send-message tool: notifications and prompts. Notifications broadcast information immediately without awaiting feedback. Prompts post embed questions with optional clickable action buttons or accept text replies, holding the MCP tool execution open until an answer is received or the optional timeout expires.

Which MCP clients work with MCP Relay?

MCP Relay is compatible with any client supporting the Model Context Protocol that allows local stdio server configuration, such as Claude Desktop. You configure the server by adding the node command, build path, Discord bot token, and Discord channel ID to your client configuration JSON file.

Can MCP Relay handle human input timeouts?

Yes, prompts sent through the send-message tool accept an optional timeout parameter measured in milliseconds. If an operator clicks an action button or enters a text response before the duration elapses, the response is returned; otherwise, the tool fails gracefully once the timeout period expires.