discord-streaming

Claude Code Discord MCP plugin with Tier-2 progress streaming — Claude narrates its work in real time without spamming your notifications.

Part of The Agent Crafting Table — standalone Claude Code agent components.

How It Works

sequenceDiagram
    participant U as User (Discord)
    participant B as Bot (MCP Plugin)
    participant CL as Claude Code

    U->>B: Send message
    B->>CL: Forward to Claude context
    CL->>B: post_update("🔍 Reading config file...")
    B->>B: Create working message (or edit existing)
    Note over B,U: Silent edit — no notification ping

    CL->>B: post_update("📡 Checking SSH connection...")
    B->>B: Edit same working message
    Note over B,U: Silent edit — no notification ping

    CL->>B: post_update("🛠️ Applying fix...")
    B->>B: Edit same working message
    Note over B,U: Silent edit — no notification ping

    CL->>B: reply("✅ Done — updated nginx config and restarted.")
    B->>U: NEW message posted
    Note over B,U: Notification ping — user is alerted
    B->>B: Clear working message reference

Loading

graph LR
    subgraph "MCP Tools"
        T1["reply(chat_id, text)
Send final answer
pings user
clears working message"]
        T2["post_update(chat_id, text)
Edit working message silently
or create new if none exists"]
        T3["fetch_messages(channel, limit)
Read recent channel history"]
    end

    subgraph "vs fleet-discord"
        SINGLE["discord-streaming
single session
no peer routing
no busy-file isolation
no stuck-task watchdog"]
        FLEET["fleet-discord
multi-session
includes all of this
+ session claim routing"]
    end

Loading

User message → Claude starts working
                ↓
          post_update("🔍 Reading config file...")    ← edits same msg, no ping
                ↓
          post_update("📡 Checking SSH connection...")  ← edits again
                ↓
          post_update("🛠️ Applying fix...")
                ↓
          reply("✅ Done — updated nginx config and restarted.")  ← NEW msg, pings you

One working message gets updated silently throughout the task. When the answer lands, you get a single notification.

Tools

Tool	Description
reply(chat_id, text)	Send final answer — pings user, clears working message
post_update(chat_id, text)	Edit working message silently, or post new one if none exists
fetch_messages(channel, limit)	Read recent channel history

Setup

1. Create a Discord bot

• Go to discord.com/developers/applications
• New Application → Bot → copy token
• Enable: Server Members Intent, Message Content Intent
• Invite to your server with bot + Send Messages + Read Message History scopes

2. Install

git clone https://github.com/Agent-Crafting-Table/discord-streaming
cd discord-streaming
bun install

3. Configure Claude Code

Add to your ~/.claude/settings.json (or project .claude/settings.json):

{
  "mcpServers": {
    "discord": {
      "command": "bun",
      "args": ["/path/to/discord-streaming/src/server.ts"],
      "env": {
        "DISCORD_BOT_TOKEN": "your-bot-token-here"
      }
    }
  }
}

4. Test

Mention the bot in Discord — it should start typing. Send a multi-step request and watch the working message update.

vs fleet-discord

This is the standalone version — no peer routing, no busy-file isolation, no watchdog. One Claude Code session, one bot.

If you're running multiple Claude Code sessions sharing one bot (fleet setup), use fleet-discord instead — it includes all of this plus session-level claim routing.