Cloud Discord
On this page
Cloud Discord is a full-featured Discord MCP server that gives AI agents complete control over Discord servers. 59 tools across 14 categories, running on Cloudflare Workers.
GitHub MIT License
The public repo’s own README carries a stale 12-category table that undercounts by 5 tools even though its “59 tools” headline is correct. The table below is recounted directly from src/tools.ts’s 59 discord_* tool definitions.
Tools (59)
| Category | Count | What You Can Do |
|---|---|---|
| Messaging | 8 | Send, edit, delete, bulk delete, read history, embeds, DMs |
| Moderation | 4 | Kick, ban, unban, timeout members |
| Roles | 7 | Create, edit, delete, assign, remove, list member roles |
| Channels | 7 | List servers, create, edit, delete channels, slowmode, permissions |
| Threads | 3 | Create, manage (archive/lock), delete threads |
| Forums | 10 | Create/edit/list posts, manage tags, default reaction, layout settings |
| Reactions | 3 | Add, remove, get reactions |
| Pins | 3 | Pin, unpin, list pinned messages |
| Files | 2 | Send files to channels or DMs (URL or base64) |
| Images | 2 | Fetch an image from a channel or DM |
| Voice | 1 | Text-to-speech voice notes via ElevenLabs |
| Server | 5 | Guild info, audit log, member list, nickname, user info |
| Invites | 3 | Create, list, delete invites |
| Polls | 1 | Native Discord polls |
Bonus Features
/vibeslash command — AI-powered channel vibe check (requires Anthropic API key)- Direct file upload endpoint — send files without base64 encoding
- Rate limit handling — automatic retry on Discord rate limits
Setup
1. Create a Discord Bot
- Go to the Discord Developer Portal
- Create a new application
- Under the Bot tab, reset the token and save it
- Enable Message Content Intent
- Under OAuth2 > URL Generator, select
bot+applications.commandsscopes withAdministratorpermissions - Use the generated URL to invite the bot to your server
2. Clone and Install
git clone https://github.com/codependentai/cloud-discord.git
cd cloud-discord
npm install
3. Configure
Edit wrangler.toml:
[vars]
MCP_SECRET_PATH = "your-random-secret" # openssl rand -base64 24
DISCORD_PUBLIC_KEY = "your-public-key" # From Developer Portal
4. Set Secrets
# Required
npx wrangler secret put DISCORD_BOT_TOKEN
# Optional — for /vibe command
npx wrangler secret put ANTHROPIC_API_KEY
# Optional — for voice notes
npx wrangler secret put ELEVENLABS_API_KEY
5. Deploy
npx wrangler deploy
6. Connect to Your MCP Client
Your MCP endpoint is:
https://your-worker.workers.dev/mcp/your-secret-path
Add to Claude Code (.mcp.json):
{
"mcpServers": {
"discord": {
"type": "url",
"url": "https://your-worker.workers.dev/mcp/your-secret-path"
}
}
}
Architecture
Single Cloudflare Worker with:
- Secret-path authentication — your MCP endpoint is only accessible with your secret URL
- Discord REST API v10 — all operations go through Discord’s HTTP API
- Rate limit retry — automatic handling of Discord’s rate limits
- Multipart form data — for file uploads and voice notes
Use Cases
- AI server management — let your AI moderate, organise channels, manage roles
- Automated posting — schedule announcements, cross-post content
- Community tools — forum management, reaction tracking, audit logging
- Bot infrastructure — build Discord workflows without writing a traditional bot