{"_id":"@chinchillaenterprises/mcp-discord","_rev":"5-7d8e33bec73172e40f00c79190affdba","name":"@chinchillaenterprises/mcp-discord","dist-tags":{"latest":"3.0.0"},"versions":{"1.0.0":{"name":"@chinchillaenterprises/mcp-discord","version":"1.0.0","keywords":["mcp","discord","bot","messaging","modelcontextprotocol","multi-account"],"author":{"name":"Chinchilla Enterprises"},"license":"MIT","_id":"@chinchillaenterprises/mcp-discord@1.0.0","maintainers":[{"name":"feathars91","email":"abel@chinchilla-ai.com"},{"name":"kqboy15","email":"kael@chinchilla-ai.com"},{"name":"soroush911","email":"soroush@chinchilla-ai.com"}],"homepage":"https://github.com/ChinchillaEnterprises/ChillMCP/tree/main/mcp-discord","bugs":{"url":"https://github.com/ChinchillaEnterprises/ChillMCP/issues"},"bin":{"mcp-discord":"dist/index.js"},"dist":{"shasum":"ebf73c5436e108764f429167a3464deb6e940430","tarball":"https://registry.npmjs.org/@chinchillaenterprises/mcp-discord/-/mcp-discord-1.0.0.tgz","fileCount":5,"integrity":"sha512-Njk59t724YMgbw1ydSlK43lJPOwxCaxG1s969g+7S6QJoIXDuPmJbZdJZwRixp+vBZwF8i2TPFcfegyb5AfCxA==","signatures":[{"sig":"MEUCIQCA7o7COvXKSwrCWYG4C7BZgOTH241RvgQiYppCD+6CvAIgY9Zfn95RsVHcoZM03AfFEyPfrtHYHKcD9MGJIpaLHHQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":119302},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e535171532c880e58e44275256599628c5e1d62f","scripts":{"dev":"tsc --watch","test":"jest","build":"tsc","prepare":"npm run build","test:watch":"jest --watch","test:coverage":"jest --coverage"},"_npmUser":{"name":"kqboy15","actor":{"name":"kqboy15","type":"user","email":"kael@chinchilla-ai.com"},"email":"kael@chinchilla-ai.com"},"repository":{"url":"git+https://github.com/ChinchillaEnterprises/ChillMCP.git","type":"git"},"_npmVersion":"11.4.1","description":"Multi-account MCP server for Discord with persistent credential storage and comprehensive bot management","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^3.25.64","keytar":"^7.9.0","fuse.js":"^7.1.0","discord.js":"^14.16.3","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.1.2","typescript":"^5.8.3","@types/jest":"^29.5.12","@types/node":"^24.0.1","@jest/globals":"^29.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_1.0.0_1751499611718_0.6600199710160364","host":"s3://npm-registry-packages-npm-production"}},"2.0.0":{"name":"@chinchillaenterprises/mcp-discord","version":"2.0.0","keywords":["mcp","discord","bot","messaging","modelcontextprotocol","multi-account"],"author":{"name":"Chinchilla Enterprises"},"license":"MIT","_id":"@chinchillaenterprises/mcp-discord@2.0.0","maintainers":[{"name":"feathars91","email":"abel@chinchilla-ai.com"},{"name":"kqboy15","email":"kael@chinchilla-ai.com"},{"name":"soroush911","email":"soroush@chinchilla-ai.com"}],"homepage":"https://github.com/ChinchillaEnterprises/ChillMCP/tree/main/mcp-discord","bugs":{"url":"https://github.com/ChinchillaEnterprises/ChillMCP/issues"},"bin":{"mcp-discord":"dist/index.js"},"dist":{"shasum":"6a5856f4b81d4c7a82cb6372a6df6fda8f4ce9ab","tarball":"https://registry.npmjs.org/@chinchillaenterprises/mcp-discord/-/mcp-discord-2.0.0.tgz","fileCount":5,"integrity":"sha512-wnTiVVe1ykJexWy9PST/0PWThXkzJZQocLlIpxWrz5uiFTO/gGQRV40u38OrvMhyuIG9ndiO4pg2mtUswUZK5Q==","signatures":[{"sig":"MEUCID7rI3hk9NO/bAo9a1mN8EVU9IuQm3Pit9kRERS0TmrwAiEAz82CaXuVDwo6DT3i72Xxwks3/r5JqHzbrSXUjFHKryo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":272996},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"3f2b9b0f6a638436bbf2162d14b410ccabdc92ef","scripts":{"dev":"tsc --watch","test":"jest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"jest --watch","test:coverage":"jest --coverage"},"_npmUser":{"name":"kqboy15","actor":{"name":"kqboy15","type":"user","email":"kael@chinchilla-ai.com"},"email":"kael@chinchilla-ai.com"},"repository":{"url":"git+https://github.com/ChinchillaEnterprises/ChillMCP.git","type":"git"},"_npmVersion":"11.4.1","description":"Comprehensive Discord MCP server with full administrator permissions and 50+ tools for complete server management","directories":{},"_nodeVersion":"20.19.2","dependencies":{"zod":"^3.25.64","keytar":"^7.9.0","fuse.js":"^7.1.0","discord.js":"^14.16.3","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.1.2","typescript":"^5.8.3","@types/jest":"^29.5.12","@types/node":"^24.0.1","@jest/globals":"^29.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_2.0.0_1751581869549_0.963692773581778","host":"s3://npm-registry-packages-npm-production"}},"3.0.0":{"name":"@chinchillaenterprises/mcp-discord","version":"3.0.0","keywords":["mcp","discord","bot","messaging","modelcontextprotocol","multi-account"],"author":{"name":"Chinchilla Enterprises"},"license":"MIT","_id":"@chinchillaenterprises/mcp-discord@3.0.0","maintainers":[{"name":"feathars91","email":"abel@chinchilla-ai.com"},{"name":"kqboy15","email":"kael@chinchilla-ai.com"},{"name":"soroush911","email":"soroush@chinchilla-ai.com"}],"homepage":"https://github.com/ChinchillaEnterprises/ChillMCP/tree/main/mcp-discord","bugs":{"url":"https://github.com/ChinchillaEnterprises/ChillMCP/issues"},"bin":{"mcp-discord":"dist/index.js"},"dist":{"shasum":"a0bcaf00cb03635ffcf7342f4f6289099d604b36","tarball":"https://registry.npmjs.org/@chinchillaenterprises/mcp-discord/-/mcp-discord-3.0.0.tgz","fileCount":209,"integrity":"sha512-NZ6h0Y/X1YcAXnoRDJGIF4b1iAJQRf91jHdd91SWwI+kk3bHQ7K4XOzPFfbEK6Nn/3evzG4E9HW4MompDCpodw==","signatures":[{"sig":"MEUCIBF92rFBYlIRFo3RUgEj+lPtVt5zg9phbcpzr4yGZFFHAiEAi+tKnLhdLuaz/yd77MJm/3+UswohUJ+dwVr7EkoFIXo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":471041},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"e4db1ca7017ceceb15bb9fb3919cf76523662b40","scripts":{"dev":"tsc --watch","test":"jest","build":"tsc","start":"node dist/index.js","prepare":"npm run build","test:watch":"jest --watch","test:coverage":"jest --coverage"},"_npmUser":{"name":"feathars91","email":"abel@chinchilla-ai.com"},"repository":{"url":"git+https://github.com/ChinchillaEnterprises/ChillMCP.git","type":"git"},"_npmVersion":"10.9.2","description":"Modular Discord MCP server with 45+ tools for comprehensive server management, featuring clean architecture and discord_ prefixed tools","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.25.64","keytar":"^7.9.0","fuse.js":"^7.1.0","discord.js":"^14.16.3","@modelcontextprotocol/sdk":"^1.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^29.7.0","ts-jest":"^29.1.2","typescript":"^5.8.3","@types/jest":"^29.5.12","@types/node":"^24.0.1","@jest/globals":"^29.7.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_3.0.0_1752463252610_0.4042862948619077","host":"s3://npm-registry-packages-npm-production"}}},"time":{"created":"2025-07-02T23:40:11.656Z","modified":"2026-03-24T01:13:32.031Z","1.0.0":"2025-07-02T23:40:11.907Z","2.0.0":"2025-07-03T22:31:09.745Z","3.0.0":"2025-07-14T03:20:52.786Z"},"bugs":{"url":"https://github.com/ChinchillaEnterprises/ChillMCP/issues"},"author":{"name":"Chinchilla Enterprises"},"license":"MIT","homepage":"https://github.com/ChinchillaEnterprises/ChillMCP/tree/main/mcp-discord","keywords":["mcp","discord","bot","messaging","modelcontextprotocol","multi-account"],"repository":{"url":"git+https://github.com/ChinchillaEnterprises/ChillMCP.git","type":"git"},"description":"Modular Discord MCP server with 45+ tools for comprehensive server management, featuring clean architecture and discord_ prefixed tools","maintainers":[{"email":"abel@chinchilla-ai.com","name":"feathars91"}],"readme":"# Discord MCP Server\n\nMulti-account MCP server for Discord with secure credential storage and comprehensive bot management capabilities.\n\n## Features\n\n### Account Management (7 tools)\n- **Multi-account support** - Manage multiple Discord bots/servers\n- **Secure credential storage** - OS keychain integration with encrypted file fallback\n- **Runtime switching** - Change between Discord accounts seamlessly\n\n### Core Messaging (12 tools implemented, more coming)\n- ✅ **Send messages** - Text and rich embeds with replies\n- ✅ **Edit messages** - Modify bot's own messages\n- ✅ **Delete messages** - Remove messages from channels\n- ✅ **Add reactions** - React with emojis\n- ✅ **Channel history** - Fetch recent messages\n- 🚧 Pin/unpin messages\n- 🚧 Send DMs\n- 🚧 Forward messages\n- 🚧 Send files\n\n### Server Management (coming soon)\n- 🚧 List guilds/channels\n- 🚧 Member management\n- 🚧 Role assignment\n- 🚧 Permission management\n\n## Installation\n\n```bash\n# Install globally with user scope\nclaude mcp add discord -s user -- npx @chinchillaenterprises/mcp-discord\n\n# Or with environment variables\nclaude mcp add discord -s user \\\n  -e DISCORD_TOKEN=\"your_bot_token_here\" \\\n  -e DISCORD_GUILD_ID=\"optional_guild_id\" \\\n  -- npx @chinchillaenterprises/mcp-discord\n```\n\n## Setup\n\n### 1. Create Discord Application\n\n1. Go to [Discord Developer Portal](https://discord.com/developers/applications)\n2. Click \"New Application\" and give it a name\n3. Go to \"Bot\" section\n4. Click \"Reset Token\" and copy your bot token\n\n### 2. Set Bot Permissions\n\nIn the Bot section, configure these permissions:\n- Send Messages\n- Read Message History  \n- Manage Messages\n- Add Reactions\n- View Channels\n\n### 3. Invite Bot to Server\n\n1. Go to OAuth2 → URL Generator\n2. Select scopes: `bot`\n3. Select the permissions above\n4. Copy the generated URL and open it\n5. Select your server and authorize\n\n### 4. Configure MCP Server\n\n```bash\n# Start Claude\nclaude\n\n# Add your Discord account\n\"Use add_account to add a Discord bot with ID 'my-bot', name 'My Discord Bot', and token 'your_bot_token_here'\"\n\n# List accounts\n\"List my Discord accounts\"\n\n# Test messaging\n\"Send a message to #general saying 'Hello from Discord MCP!'\"\n```\n\n## Usage Examples\n\n### Basic Messaging\n\n```\n# Send text message (using channel name)\n\"Send a message to #general with text 'Hello Discord!'\"\n\"Send 'Good morning!' to the announcements channel\"\n\n# Send rich embed (using channel name)\n\"Send an embed to #general with title 'Welcome' and description 'This is a test embed' with color 0x00ff00\"\n\n# Reply to a message\n\"Send 'Great question!' as a reply to message 1234567890 in #help-desk\"\n\n# Using channel IDs still works\n\"Send a message to channel 123456789012345678 with text 'Hello Discord!'\"\n```\n\n### Message Management\n\n```\n# Edit a message\n\"Edit message 1234567890 in #general to say 'Updated message!'\"\n\n# Delete a message  \n\"Delete message 1234567890 from the announcements channel\"\n\n# Add reaction\n\"Add a 👍 reaction to message 1234567890 in general\"\n```\n\n### Channel History\n\n```\n# Get recent messages\n\"Get the last 20 messages from #general\"\n\"Show me recent messages in help-desk\"\n\n# Get messages before a specific message\n\"Get 50 messages from #announcements before message 1234567890\"\n```\n\n### Channel Name Resolution\n\nThe Discord MCP server intelligently resolves channel names:\n- **Exact match**: `#general` → finds \"general\" channel\n- **Without hashtag**: `general` → finds \"general\" channel  \n- **Partial match**: `announce` → finds \"announcements\" channel\n- **Case insensitive**: `General` → finds \"general\" channel\n- **Channel IDs**: `1390027279156908238` → uses ID directly\n\nIf multiple channels match, it uses the best match and logs alternatives.\n\n## Account Management\n\n### Add Account\n```\n{\n  \"id\": \"work-bot\",\n  \"name\": \"Work Discord Bot\", \n  \"token\": \"your_bot_token\",\n  \"guildId\": \"optional_guild_id\",\n  \"setAsDefault\": true\n}\n```\n\n### Switch Accounts\n```\n\"Switch to Discord account work-bot\"\n```\n\n### List Accounts\n```\n\"List all my Discord accounts\"\n```\n\n## Available Tools\n\n### Account Management\n- `list_accounts` - List all configured Discord accounts\n- `add_account` - Add new Discord bot configuration\n- `switch_account` - Switch active Discord account\n- `remove_account` - Remove account configuration\n- `get_active_account` - Show current active account\n- `set_default_account` - Set default account\n- `update_account` - Update credentials\n\n### Messaging Tools\n- `discord_send_message` - Send messages with text/embeds\n- `discord_edit_message` - Edit existing messages\n- `discord_delete_message` - Delete messages\n- `discord_add_reaction` - Add emoji reactions\n- `discord_get_channel_history` - Fetch channel messages\n\n## Security\n\n- Bot tokens are stored securely using OS keychain (when available)\n- Fallback to encrypted file storage with AES-256-CBC\n- Credentials are never logged or exposed\n- Each account is isolated\n\n## Requirements\n\n- Node.js 18+\n- Discord bot token\n- Discord server with bot invited\n\n## Troubleshooting\n\n### Bot not responding\n- Check bot has required permissions in the channel\n- Verify bot is online in Discord\n- Ensure token is valid (starts with 'MTM...')\n\n### Channel not found\n- Verify channel ID is correct\n- Ensure bot has access to the channel\n- Check if it's a text channel (not voice)\n\n### Permission errors  \n- Bot needs \"Send Messages\" permission\n- For editing/deleting: \"Manage Messages\"\n- For reactions: \"Add Reactions\"\n\n## Development\n\n```bash\n# Clone and setup\ngit clone https://github.com/ChinchillaEnterprises/ChillMCP.git\ncd ChillMCP/mcp-discord\nnpm install\n\n# Build\nnpm run build\n\n# Test locally\nclaude mcp add discord-local -s user -- node $(pwd)/dist/index.js\n```\n\n## License\n\nMIT - Chinchilla Enterprises\n\n## Support\n\nReport issues at: https://github.com/ChinchillaEnterprises/ChillMCP/issues","readmeFilename":"README.md"}