{"_id":"mcp-discord","_rev":"7-f3413f6ada185846160782491c765702","name":"mcp-discord","dist-tags":{"latest":"1.3.4"},"versions":{"1.3.0":{"name":"mcp-discord","version":"1.3.0","keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","_id":"mcp-discord@1.3.0","maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"homepage":"https://github.com/barryyip0625/mcp-discord#readme","bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"bin":{"mcp-discord":"build/index.js"},"dist":{"shasum":"36265e91899b6e3cf2b38219df2cfea6d5c152b3","tarball":"https://registry.npmjs.org/mcp-discord/-/mcp-discord-1.3.0.tgz","fileCount":19,"integrity":"sha512-a7vxn2MBhpOzPVsQILal2fHWNIpxg3YVkPao9r6CXLzwfE/RfEiPlVx13mIl6gk4HLg9lOvCwtgMo1j0NH0v2Q==","signatures":[{"sig":"MEYCIQDLPoy1HOxt2qO9ORY/Tg5+CsbI4gmL0L93qDnSc0wTuwIhAO14ZcN1BqkrCiSpxp61IgG/QyltKycCayokGAWdZaIo","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22199515},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c37e55d5f59f44e81ae861437e27c58bc14f7f49","scripts":{"dev":"node --loader ts-node/esm src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node build/index.js","test-api":"node test-api.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"barry99625","actor":{"name":"barry99625","type":"user","email":"barry99625@gmail.com"},"email":"barry99625@gmail.com"},"repository":{"url":"git+https://github.com/barryyip0625/mcp-discord.git","type":"git"},"_npmVersion":"10.9.0","description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","directories":{},"_nodeVersion":"20.18.0","dependencies":{"zod":"^3.25.13","dotenv":"^16.5.0","express":"^5.1.0","discord.js":"^14.19.3"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^20.17.50","@types/express":"^5.0.1","@modelcontextprotocol/sdk":"^1.11.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_1.3.0_1751978249744_0.895074632446891","host":"s3://npm-registry-packages-npm-production"}},"1.3.1":{"name":"mcp-discord","version":"1.3.1","keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","_id":"mcp-discord@1.3.1","maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"homepage":"https://github.com/barryyip0625/mcp-discord#readme","bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"bin":{"mcp-discord":"build/index.js"},"dist":{"shasum":"696c3f1183b4047d11833b3e463c8cd0ab4951bc","tarball":"https://registry.npmjs.org/mcp-discord/-/mcp-discord-1.3.1.tgz","fileCount":19,"integrity":"sha512-HJuqU2cQLWiXHNDTAeLm3fjFsqh9ctKb6LMVuzxF5PjVYLZvcI798jxl/g+nx5oXA3G/zVaVEaYmwGlFoq/+fg==","signatures":[{"sig":"MEYCIQDMgh8rrYUoWXMAAe3dwa/xHjjM5X27mmeclT957swuGAIhAPklCwmrCWLBPcFRT5LGDr+c3c7YDdsJmtR7gbS3OR0l","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22199535},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c37e55d5f59f44e81ae861437e27c58bc14f7f49","scripts":{"dev":"node --loader ts-node/esm src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node build/index.js","test-api":"node test-api.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"barry99625","actor":{"name":"barry99625","type":"user","email":"barry99625@gmail.com"},"email":"barry99625@gmail.com"},"repository":{"url":"git+https://github.com/barryyip0625/mcp-discord.git","type":"git"},"_npmVersion":"10.9.0","description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","directories":{},"_nodeVersion":"20.18.0","dependencies":{"zod":"^3.25.13","dotenv":"^16.5.0","express":"^5.1.0","discord.js":"^14.19.3"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^20.17.50","@types/express":"^5.0.1","@modelcontextprotocol/sdk":"^1.11.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_1.3.1_1751979718463_0.3539957059188814","host":"s3://npm-registry-packages-npm-production"}},"1.3.2":{"name":"mcp-discord","version":"1.3.2","keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","_id":"mcp-discord@1.3.2","maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"homepage":"https://github.com/barryyip0625/mcp-discord#readme","bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"bin":{"mcp-discord":"build/index.js"},"dist":{"shasum":"e769305ee5fc4fbd4124b22858dbb69f2291ef29","tarball":"https://registry.npmjs.org/mcp-discord/-/mcp-discord-1.3.2.tgz","fileCount":19,"integrity":"sha512-rVHAF21TcuCXYjtuttcD1CSZsg80g+dZPLIejcFdtzN94Ww2PuV33eujvgW7Lpx8lqmQDYICvWyhxuHE7qDKHQ==","signatures":[{"sig":"MEUCIQDgli6JIAuDk5YyE33K1+tnqMa54fL9LIfRDs1KGaM63wIgB/rMvPDAZi28yyBTHlGNz+IB+qsvba4MYdJvpHDUGY8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22199535},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"c37e55d5f59f44e81ae861437e27c58bc14f7f49","scripts":{"dev":"node --loader ts-node/esm src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node build/index.js","test-api":"node test-api.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"barry99625","actor":{"name":"barry99625","type":"user","email":"barry99625@gmail.com"},"email":"barry99625@gmail.com"},"repository":{"url":"git+https://github.com/barryyip0625/mcp-discord.git","type":"git"},"_npmVersion":"10.9.0","description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","directories":{},"_nodeVersion":"20.18.0","dependencies":{"zod":"^3.25.13","dotenv":"^16.5.0","express":"^5.1.0","discord.js":"^14.19.3","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^20.17.50","@types/express":"^5.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_1.3.2_1751979889424_0.5695176383378178","host":"s3://npm-registry-packages-npm-production"}},"1.3.3":{"name":"mcp-discord","version":"1.3.3","keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","_id":"mcp-discord@1.3.3","maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"homepage":"https://github.com/barryyip0625/mcp-discord#readme","bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"bin":{"mcp-discord":"build/index.js"},"dist":{"shasum":"674e63b377dc90985ac1aa6645598b2c0d07ef81","tarball":"https://registry.npmjs.org/mcp-discord/-/mcp-discord-1.3.3.tgz","fileCount":19,"integrity":"sha512-JHt7S6IRmVAldXBgol2Kn7YjyvHLxoMjTfEK7PVG3W4vpCTNjGWNKpsSh1DS7AAX0Lg3/83X7Oaxi8p+ublHIQ==","signatures":[{"sig":"MEUCICnUVf+tKItj9tK/m5jvp3zVGibHUryeDs1PyDquI6UCAiEA0bU/3Bs7mbidd6NS0oJserYIydVuRZCJTZVvYEWhVSs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22161460},"main":"build/index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"6ed5adbc7ea447cd4b9a015be1d36b1d93928cb0","scripts":{"dev":"node --loader ts-node/esm src/index.ts","test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node build/index.js","test-api":"node test-api.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"barry99625","actor":{"name":"barry99625","type":"user","email":"barry99625@gmail.com"},"email":"barry99625@gmail.com"},"repository":{"url":"git+https://github.com/barryyip0625/mcp-discord.git","type":"git"},"_npmVersion":"10.9.2","description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","directories":{},"_nodeVersion":"22.16.0","dependencies":{"zod":"^3.25.13","dotenv":"^16.5.0","express":"^5.1.0","discord.js":"^14.19.3","@modelcontextprotocol/sdk":"^1.11.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.8.3","@types/node":"^20.17.50","@types/express":"^5.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp-discord_1.3.3_1752119045472_0.8452742146433454","host":"s3://npm-registry-packages-npm-production"}},"1.3.4":{"name":"mcp-discord","version":"1.3.4","description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","main":"build/index.js","bin":{"mcp-discord":"build/index.js"},"type":"module","scripts":{"test":"echo \"Error: no test specified\" && exit 1","build":"tsc","start":"node build/index.js","dev":"node --loader ts-node/esm src/index.ts","test-api":"node test-api.js","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/barryyip0625/mcp-discord.git"},"bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"homepage":"https://github.com/barryyip0625/mcp-discord#readme","engines":{"node":">=18.0.0"},"devDependencies":{"@types/express":"^5.0.1","@types/node":"^20.17.50","ts-node":"^10.9.2","typescript":"^5.8.3"},"dependencies":{"@modelcontextprotocol/sdk":"^1.11.0","discord.js":"^14.19.3","dotenv":"^16.5.0","express":"^5.1.0","zod":"^3.25.13"},"_id":"mcp-discord@1.3.4","gitHead":"06aa6ecca1b1291700248e6f08fd2528d50e17c6","_nodeVersion":"22.16.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-SefGAi5bqDzV8dmCXp6aqDh2v3mXFI/2au/mmNeXAdYrVp8/reI2MYOpNWrqMJHL3C48BSFJBatpbnZKkIhWyQ==","shasum":"18a0387a895eecbd782b62b13229ec0c1fee4450","tarball":"https://registry.npmjs.org/mcp-discord/-/mcp-discord-1.3.4.tgz","fileCount":19,"unpackedSize":22161460,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD7G16THzenDaBzMw3f1aiAveHzQuER95HrtkNbuecGWgIhAPRAMt+h0EXGsBeoEynf2Wrpa7Uvy2HO6ccb1ZGe+C6T"}]},"_npmUser":{"name":"barry99625","email":"barry99625@gmail.com","actor":{"name":"barry99625","email":"barry99625@gmail.com","type":"user"}},"directories":{},"maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-discord_1.3.4_1752119526376_0.6551360759829463"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-08T12:37:29.743Z","modified":"2025-07-10T03:52:06.806Z","1.2.0":"2025-05-22T03:04:57.040Z","1.3.0":"2025-07-08T12:37:30.028Z","1.3.1":"2025-07-08T13:01:58.694Z","1.3.2":"2025-07-08T13:04:49.711Z","1.3.3":"2025-07-10T03:44:05.688Z","1.3.4":"2025-07-10T03:52:06.643Z"},"bugs":{"url":"https://github.com/barryyip0625/mcp-discord/issues"},"author":{"name":"Barry Yip","email":"barry99625@gmail.com"},"license":"MIT","homepage":"https://github.com/barryyip0625/mcp-discord#readme","keywords":["mcp","model-context-protocol","discord","claude","ai","chatbot","automation"],"repository":{"type":"git","url":"git+https://github.com/barryyip0625/mcp-discord.git"},"description":"Model Context Protocol (MCP) server for Discord integration, allowing Claude and other MCP clients to interact with Discord","maintainers":[{"name":"barry99625","email":"barry99625@gmail.com"}],"readme":"# MCP-Discord\r\n[![smithery badge](https://smithery.ai/badge/@barryyip0625/mcp-discord)](https://smithery.ai/server/@barryyip0625/mcp-discord) ![](https://badge.mcpx.dev?type=server 'MCP Server')\r\n\r\nA Discord MCP (Model Context Protocol) server that enables AI assistants to interact with the Discord platform.\r\n\r\n<a href=\"https://glama.ai/mcp/servers/@barryyip0625/mcp-discord\">\r\n  <img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/@barryyip0625/mcp-discord/badge\" alt=\"MCP-Discord MCP server\" />\r\n</a>\r\n\r\n## Overview\r\n\r\nMCP-Discord provides the following Discord-related functionalities:\r\n\r\n- Login to Discord bot\r\n- Get server information\r\n- Read/delete channel messages\r\n- Send messages to specified channels (using either channel IDs or channel names)\r\n- Retrieve forum channel lists\r\n- Create/delete/reply to forum posts\r\n- Create/delete text channels\r\n- Add/remove message reactions\r\n- Create/edit/delete/use webhooks\r\n\r\n## Table of Contents\r\n\r\n- [Prerequisites](#prerequisites)\r\n- [Installation](#installation)\r\n- [Configuration](#configuration)\r\n- [Tools Documentation](#tools-documentation)\r\n  - [Basic Functions](#basic-functions)\r\n  - [Channel Management](#channel-management)\r\n  - [Forum Functions](#forum-functions)\r\n  - [Messages and Reactions](#messages-and-reactions)\r\n  - [Webhook Management](#webhook-management)\r\n- [Development](#development)\r\n- [License](#license)\r\n\r\n## Prerequisites\r\n\r\n- Node.js (v16.0.0 or higher)\r\n- npm (v7.0.0 or higher)\r\n- A Discord bot with appropriate permissions\r\n  - Bot token (obtainable from the [Discord Developer Portal](https://discord.com/developers/applications))\r\n  - Message Content Intent enabled\r\n  - Server Members Intent enabled\r\n  - Presence Intent enabled\r\n- Permissions required in your Discord server:\r\n\r\n  #### Easiest Setup\r\n  - Administrator (Recommended for quick setup and full functionality)\r\n\r\n  #### Or, select only the required permissions:\r\n  - Send Messages\r\n  - Create Public Threads\r\n  - Send Messages in Threads\r\n  - Manage Messages\r\n  - Manage Threads\r\n  - Manage Channels\r\n  - Manage Webhooks\r\n  - Add Reactions\r\n  - View Channel\r\n\r\n- Add your Discord bot to your server\r\n  - To add your Discord bot to your server, use one of the following invite links (replace `INSERT_CLIENT_ID_HERE` with your bot's client ID):\r\n    - **Administrator (full access):**\r\n        https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=8\r\n    - **Custom permissions (minimum required):**\r\n        https://discord.com/oauth2/authorize?client_id=INSERT_CLIENT_ID_HERE&scope=bot&permissions=52076489808\r\n\r\n> **Note:**  \r\n> According to Discord's security model, a bot can only access information from servers it has been explicitly added to.  \r\n> If you want to use this MCP server to access a specific Discord server, you must add the bot to that server first.  \r\n> Use the invite link below to add the bot to your target server.\r\n\r\n## Installation\r\n\r\n### Installing via NPM\r\n\r\nYou can use it with the following command:\r\n```bash\r\nnpx mcp-discord --config ${DISCORD_TOKEN}\r\n```\r\n\r\nFor more details, you can check out the [NPM Package](https://www.npmjs.com/package/mcp-discord).\r\n\r\n### Installing via Smithery\r\n\r\nTo install mcp-discord automatically via [Smithery](https://smithery.ai/server/@barryyip0625/mcp-discord)\r\n\r\n### Manual Installation\r\n```bash\r\n# Clone the repository\r\ngit clone https://github.com/barryyip0625/mcp-discord.git\r\ncd mcp-discord\r\n\r\n# Install dependencies\r\nnpm install\r\n\r\n# Compile TypeScript\r\nnpm run build\r\n```\r\n\r\n## Configuration\r\n\r\nA Discord bot token is required for proper operation. The server supports two transport methods: stdio and streamable HTTP.\r\n\r\n### Transport Methods\r\n\r\n1. **stdio** (Default)\r\n   - Traditional stdio transport for basic usage\r\n   - Suitable for simple integrations\r\n\r\n2. **streamable HTTP**\r\n   - HTTP-based transport for more advanced scenarios\r\n   - Supports stateless operation\r\n   - Configurable port number\r\n\r\n### Configuration Options\r\n\r\nYou can provide configuration in two ways:\r\n\r\n1. Environment variables:\r\n```bash\r\nDISCORD_TOKEN=your_discord_bot_token\r\n```\r\n\r\n2. Using command line arguments:\r\n```bash\r\n# For stdio transport (default)\r\nnode build/index.js --config \"your_discord_bot_token\"\r\n\r\n# For streamable HTTP transport\r\nnode build/index.js --transport http --port 3000 --config \"your_discord_bot_token\"\r\n```\r\n\r\n## Usage with Claude/Cursor\r\n\r\n### Claude\r\n\r\n1. Using stdio transport:\r\n```json\r\n{\r\n    \"mcpServers\": {\r\n        \"discord\": {\r\n            \"command\": \"node\",\r\n            \"args\": [\r\n                \"path/to/mcp-discord/build/index.js\",\r\n                \"--config\",\r\n                \"your_discord_bot_token\"\r\n            ]\r\n        }\r\n    }\r\n}\r\n```\r\n\r\n2. Using streamable HTTP transport:\r\n```json\r\n{\r\n    \"mcpServers\": {\r\n        \"discord\": {\r\n            \"command\": \"node\",\r\n            \"args\": [\r\n                \"path/to/mcp-discord/build/index.js\",\r\n                \"--transport\",\r\n                \"http\",\r\n                \"--port\",\r\n                \"3000\",\r\n                \"--config\",\r\n                \"your_discord_bot_token\"\r\n            ]\r\n        }\r\n    }\r\n}\r\n```\r\n\r\n### Cursor\r\n\r\n1. Using stdio transport:\r\n```json\r\n{\r\n    \"mcpServers\": {\r\n        \"discord\": {\r\n            \"command\": \"cmd\",\r\n            \"args\": [\r\n                \"/c\",\r\n                \"node\",\r\n                \"path/to/mcp-discord/build/index.js\",\r\n                \"--config\",\r\n                \"your_discord_bot_token\"\r\n            ]\r\n        }\r\n    }\r\n}\r\n```\r\n\r\n2. Using streamable HTTP transport:\r\n```json\r\n{\r\n    \"mcpServers\": {\r\n        \"discord\": {\r\n            \"command\": \"cmd\",\r\n            \"args\": [\r\n                \"/c\",\r\n                \"node\",\r\n                \"path/to/mcp-discord/build/index.js\",\r\n                \"--transport\",\r\n                \"http\",\r\n                \"--port\",\r\n                \"3000\",\r\n                \"--config\",\r\n                \"your_discord_bot_token\"\r\n            ]\r\n        }\r\n    }\r\n}\r\n```\r\n\r\n## Tools Documentation\r\n\r\n### Basic Functions\r\n\r\n- `discord_send`: Send a message to a specified channel (supports both channel ID and channel name)\r\n- `discord_get_server_info`: Get Discord server information\r\n\r\n### Channel Management\r\n\r\n- `discord_create_text_channel`: Create a text channel\r\n- `discord_delete_channel`: Delete a channel\r\n\r\n### Forum Functions\r\n\r\n- `discord_get_forum_channels`: Get a list of forum channels\r\n- `discord_create_forum_post`: Create a forum post\r\n- `discord_get_forum_post`: Get a forum post\r\n- `discord_reply_to_forum`: Reply to a forum post\r\n- `discord_delete_forum_post`: Delete a forum post\r\n\r\n### Messages and Reactions\r\n\r\n- `discord_read_messages`: Read channel messages\r\n- `discord_add_reaction`: Add a reaction to a message\r\n- `discord_add_multiple_reactions`: Add multiple reactions to a message\r\n- `discord_remove_reaction`: Remove a reaction from a message\r\n- `discord_delete_message`: Delete a specific message from a channel\r\n\r\n### Webhook Management\r\n\r\n- `discord_create_webhook`: Creates a new webhook for a Discord channel\r\n- `discord_send_webhook_message`: Sends a message to a Discord channel using a webhook\r\n- `discord_edit_webhook`: Edits an existing webhook for a Discord channel\r\n- `discord_delete_webhook`: Deletes an existing webhook for a Discord channel\r\n\r\n## Development\r\n\r\n```bash\r\n# Development mode\r\nnpm run dev\r\n```\r\n\r\n## License\r\n\r\n[MIT License](https://github.com/barryyip0625/mcp-discord?tab=MIT-1-ov-file)\r\n","readmeFilename":"README.md"}