Chat Human

You run an MCP Server that lets AI agents send messages to human users via chat and optionally wait for a response. This enables interactive workflows where an AI can ask humans for input, feedback, or confirmations through a supported chat platform.

How to use

Set up a chat-human MCP server and connect it to your MCP client. Your client can send messages to a human through the chat channel and decide whether to wait for a response. Use this to coordinate human-in-the-loop actions, gather human input, or request decisions in real time while keeping the AI workflow smooth and asynchronous.

How to install

Prerequisites you need before installing the MCP server are Node.js and pnpm. You also need a Discord bot with Message Content Intent enabled and permissions to Send Messages, Read Message History, and Read Messages/View Channels.

# Install prerequisites (Node.js and pnpm should be installed system-wide beforehand)
# Node.js installation varies by OS; ensure Node.js is available in your shell

# Clone the MCP server project
git clone https://github.com/palon7/mcp-chat-human.git
cd mcp-chat-human

# Install dependencies using pnpm
pnpm install

# Build the project
pnpm build

# Start using the provided MCP transport via stdio (the server will emit the build output path)
# The exact runtime command is shown in the config snippet below

Configure the MCP transport to run the local server using stdio and node, then provide Discord credentials and channel info in the environment. You will use a configuration block that points to the built entry point and passes your Discord API key and channel ID as environment variables.

"mcpServers": {
  "chat-human": {
    "type": "stdio",
    "command": "node",
    "args": [
      "/path/to/your/directory/mcp-chat-human/build/index.js"
    ],
    "env": {
      "DISCORD_API_KEY": "YOUR_DISCORD_API_KEY",
      "DISCORD_CHANNEL_ID": "YOUR_DISCORD_CHANNEL_ID"
    }
  }
}

Additional sections

Configuration details for the chat-human MCP server are provided below. Use the exact commands and environment variable names shown to ensure proper operation with your MCP client.

Important security note: Treat your Discord API key and channel ID as secrets. Do not commit them to public repositories. Use environment-specific configuration or secret management to inject these values at runtime.

Notes and examples

If you want to send a message and wait for a human response, you can configure the MCP client to issue a message with requires_response set to true. If you want to fire-and-forget messages, set requires_response to false.

Available tools

send_message

Send a message to a human user via Discord chat, with an option to wait for a response from the user.