v2.0.1

Fixed

• Welcome screen no longer clears immediately when Step 1 renders — the logo and intro stay visible while the user answers the first question
• Screen clearing now starts from Step 2 onward, preserving the branded first impression

v2.0.0 — 134 Tools, 20 Categories

What's New

35 New Tools (99 → 134)

Six new categories:

Category	Tools
Polls	send_poll, get_poll_results, end_poll
Direct Messages	send_dm, send_dm_embed
Bot Presence	set_bot_status, get_bot_info
Server Templates	list/create/delete/sync_template
Application Commands	list/create/edit/delete_command
Onboarding	get/edit_onboarding

Plus additions to existing categories:

• Channels (+4): check_permissions, copy_channel_permissions, set_voice_status, list_voice_members
• Members (+3): search_members, bulk_ban, purge_user_messages
• Roles (+2): list_role_members, list_member_permissions
• Server Admin (+3): get_invite, get_server_icon, set_server_icon
• Threads (+3): add/remove/list_thread_members
• Messages (+1): send_message_with_file
• Events (+1): get_event_subscribers

Polished Install Wizard

• Screen-clearing wizard with persistent progress header
• New block-style QUADS logo with gradient colors
• Administrator permission option — avoids role hierarchy issues
• Token format pre-validation with retry on bad tokens
• Quick permission pre-check built into setup
• QuadsLab.io and Discord community links

Bug Fixes

• Bot no longer locks itself out when making channels private
• All Discord API errors now return actionable fix instructions

Full Changelog

https://github.com/HardHeadHackerHead/discord-mcp/blob/main/CHANGELOG.md

v1.4.0 — Polished Install Wizard

What's New

Polished Install Experience

The npx @quadslab.io/discord-mcp init wizard is now significantly more polished:

• Typewriter animation on the welcome message for a premium CLI feel
• Token format pre-validation — detects malformed tokens before hitting Discord's API, tells you exactly what's wrong
• Retry on bad token — paste a new one without restarting the wizard
• Staged spinner messages — connection shows Resolving gateway... → Authenticating... → Fetching servers...
• Quick permission pre-check — right after selecting your server, see a pass/fail permission summary
• Richer guild selection — boost level indicators (⬆1, ⬆2, ⬆3) alongside member counts
• Animated completion — typewriter "Setup complete!" with a configuration summary card
• Smooth transitions — brief pauses between steps for a polished flow

Full Changelog

https://github.com/HardHeadHackerHead/discord-mcp/blob/main/CHANGELOG.md

v1.3.1 — Troubleshooting & Polish

What's New

Troubleshooting Guide

README now includes a comprehensive troubleshooting section covering every common error:

• Missing token/guild ID
• Rate limits (opcode 8)
• Missing permissions (with exact fix steps)
• Role hierarchy issues
• Intent errors
• Wrong .mcp.json directory

Actionable Error Messages

Startup errors now tell you exactly what to do:

  Error: DISCORD_TOKEN is not set.

  Run the setup wizard to configure:
    npx @quadslab.io/discord-mcp init

  Or set it manually:
    DISCORD_TOKEN=your-bot-token

Failed startups point to the health check:

  Troubleshoot with:
    npx @quadslab.io/discord-mcp check

Discoverability

• Added npm keywords: cursor, windsurf, claude-desktop, discord-admin, ai-tools
• Set GitHub repo topics for better search visibility
• Clean [discord-mcp] log prefix for startup messages

Full Changelog: v1.3.0...v1.3.1

v1.3.0 — Final Polish

What's Changed

Bug Fixes

• MCP server version was hardcoded to 1.0.0 — now reads from package.json dynamically
• CLI logo showed hardcoded v1.0 — removed (use --version instead)
• Missing permission — Manage Auto Moderation was absent from the bot setup guide
• CHANGELOG.md was excluded from the npm package — now ships with it

Documentation Overhaul

Every doc file has been updated to reflect the CLI-first workflow:

• docs/discord-mcp-server.md — Setup section completely rewritten: CLI commands, multi-client config table, manual fallback
• docs/bot-setup-guide.md — Step 6 now leads with npx init wizard instead of manual .env setup
• CONTRIBUTING.md — Added project structure diagram, CLI development section with test commands, CHANGELOG in docs checklist
• README.md — Architecture diagram updated with accurate descriptions for all source files
• .github/PULL_REQUEST_TEMPLATE.md — Added checklist items for CLI testing and CHANGELOG updates
• .env.example — Documented BOT_TOKEN fallback with comments

Package Improvements

• exports field added to package.json for clean ESM imports
• main now points to dist/index.js (library API) instead of dist/mcp-server.js (executable)
• Description updated to mention all four supported MCP clients

Full Changelog: v1.2.3...v1.3.0

v1.2.3 — Smart Directory Detection

Fixed

Smart directory detection in setup wizard

Running npx @quadslab.io/discord-mcp init from Desktop, Downloads, or your home directory no longer writes a useless .mcp.json in the wrong place.

Before: Config always written to cwd/.mcp.json — if you ran it from Desktop, Claude Code wouldn't find it.

After: The wizard detects non-project directories and automatically switches to the global ~/.claude.json config instead:

  ⚠ Current directory is Desktop — not a project folder
    Claude Code config will be written to ~/.claude.json (global, works everywhere)

Detected directories: Desktop, Downloads, Documents, home root, tmp/temp, System32.

Other clients (Claude Desktop, Cursor, Windsurf) were already using global paths and are unaffected.

Full Changelog: v1.2.2...v1.2.3

v1.2.2 — Fix @everyone Role

Fixed

@everyone role now works

The @everyone role was being filtered out of the role cache (its ID equals the guild ID, which was used as a filter). This caused errors like:

Role "@everyone" not found. Available roles: @Admin, @Moderator, ...

Now fixed with:

• Special-case handling in role lookup — @everyone, everyone, and the guild ID all resolve correctly
• @everyone is included in the role cache alongside all other roles

This affects set_channel_permissions, modify_role_permissions, assign_role, and any other tool that accepts a role name.

Full Changelog: v1.2.1...v1.2.2

v1.2.1 — Rate Limit Handling

Fixed

Automatic Rate Limit Retry

Discord rate limit errors (like Request with opcode 8 was rate limited. Retry after 20.479 seconds.) are now handled automatically:

• Startup member fetch — retries with backoff if the gateway rate-limits the initial member cache
• All 99 tool calls — wrapped with automatic retry (up to 3 attempts)
• Smart backoff — parses retry_after from Discord's error response so it waits exactly the right amount of time
• Transparent to users — retries happen silently, you just get the result

No more manual retries needed when Discord throttles requests.

Full Changelog: v1.2.0...v1.2.1

v1.2.0 — Multi-Client Setup

What's New

Multi-Client Auto-Detection

The init wizard now auto-detects all your installed MCP clients and lets you configure them in one shot:

  Detected MCP clients:

  ● Claude Code      .mcp.json
  ● Claude Desktop   claude_desktop_config.json
  ● Cursor           ~/.cursor/mcp.json
  ○ Windsurf         (not detected)

  ? Which client(s) to configure?
  1. Claude Code (detected)
  2. Claude Desktop (detected)
  3. Cursor (detected)
  4. Windsurf (not found)
  5. All detected (3 clients)
  6. Skip (show config to copy manually)

Supported Clients

Client	Config File
Claude Code	.mcp.json (project root)
Claude Desktop	claude_desktop_config.json
Cursor	~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json

• Select one client, "All detected", or "Skip" to copy config manually
• Existing configs are merged safely (won't overwrite other MCP servers)
• Next steps are tailored per client (e.g., "restart app" vs "type /mcp")

Full Changelog: v1.1.0...v1.2.0

v1.1.0 — Interactive Setup Wizard

What's New

Interactive Setup Wizard

One command to go from zero to fully configured:

npx @quadslab.io/discord-mcp init

The wizard walks you through:

• Creating a Discord bot (or using an existing one)
• Live token validation with masked input
• Auto-generated invite URL with all required permissions
• Server auto-discovery and selection
• Automatic .mcp.json generation

Health Check & Permission Audit

npx @quadslab.io/discord-mcp check

Validates your token, server access, and audits all 24 required permissions with a visual progress bar.

Polished CLI Experience

• Branded QuadsLab.io ASCII art logo
• ANSI color-coded output with NO_COLOR support
• Animated braille spinners during Discord connections
• Progress dots showing wizard completion status
• Boxed instruction cards and next-steps summary
• --help and --version flags

README Overhaul

• "Setup in 60 Seconds" section leads with npx init
• CLI output previews showing exactly what users will see
• Collapsible full tool reference (99 tools)
• Manual setup moved to expandable details sections

Full Changelog: v1.0.0...v1.1.0