discord-ops

Agency-grade Discord MCP server with multi-guild project routing.

[](https://github.com/bookedsolidtech/discord-ops/actions/workflows/ci.yml) [](https://www.npmjs.com/package/discord-ops) [](LICENSE)

• 18 MCP tools — messaging, channels, guilds, members, roles, threads, health check
• Multi-guild project routing — send_message({ project: "my-app", channel: "builds" }) instead of raw channel IDs
• Notification routing — map notification types (ci_build, deploy, error) to channels per project
• Lazy login — tools enumerate before Discord connects; first tool call triggers login
• Zod validation — all inputs validated before execution
• Error sanitization — tokens, webhook URLs, and snowflake IDs stripped from error output
• Audit logging — every tool call logged to stderr
• Fuzzy name resolution — find channels/roles/members by name, normalized name, or substring

# Install
npm install -g discord-ops

# Set your bot token
export DISCORD_TOKEN="your-bot-token"

# Run health check
discord-ops health

# Start MCP server (stdio)
discord-ops

Add to your .mcp.json:

{
  "mcpServers": {
    "discord": {
      "command": "npx",
      "args": ["-y", "discord-ops"],
      "env": {
        "DISCORD_TOKEN": "your-bot-token"
      }
    }
  }
}

The killer feature: route messages by project name and channel alias instead of raw IDs.

{
  "projects": {
    "my-app": {
      "guild_id": "123456789012345678",
      "channels": {
        "dev": "CHANNEL_ID",
        "builds": "CHANNEL_ID",
        "alerts": "CHANNEL_ID"
      },
      "default_channel": "dev"
    }
  },
  "default_pro