The Discord Raw API MCP Server provides raw access to Discord's API, allowing you to:
Execute REST API Calls: Send GET, POST, PUT, PATCH, DELETE requests to Discord API endpoints
Use Slash Command Syntax: Interact with the API using simplified slash command-style syntax (e.g.,
/role create)Manage Roles: Create, modify, assign, and delete roles
Operate Channels: Create, move, and manage various channel types
Handle Messages: Send and interact with message content
Manage Servers: Retrieve and manage guild information, members, and permissions
Include JSON Payloads: Provide optional data for complex requests
Access Full API: Use the complete range of Discord API endpoints for comprehensive server management
Provides raw Discord API access through a flexible tool, supporting both REST API calls and slash command syntax, allowing users to interact with Discord servers, create roles, send messages, and access server information.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Discord Raw API MCP Servercreate a new role called 'Moderator' with blue color in my server"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Discord Raw API MCP Server
This MCP server provides raw Discord API access through a single flexible tool. It supports both REST API calls and slash command syntax.
Installation
Installing via Smithery
To install Discord Raw API for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @hanweg/mcp-discord-raw --client claudeManual Installation
Set up your Discord bot:
Create a new application at Discord Developer Portal
Create a bot and copy the token
Enable required privileged intents:
MESSAGE CONTENT INTENT
PRESENCE INTENT
SERVER MEMBERS INTENT
Invite the bot to your server using OAuth2 URL Generator
Clone and install the package:
# Clone the repository
git clone https://github.com/hanweg/mcp-discord-raw.git
cd mcp-discord-raw
# Create and activate virtual environment
uv venv
.venv\Scripts\activate
### If using Python 3.13+ - install audioop library: `uv pip install audioop-lts`
# Install the package
uv pip install -e .Related MCP server: MCP-Discord
Configuration
Add this to your claude_desktop_config.json
"discord-raw": {
"command": "uv",
"args": [
"--directory",
"PATH/TO/mcp-discord-raw",
"run",
"discord-raw-mcp"
],
"env": {
"DISCORD_TOKEN": "YOUR-BOT-TOKEN"
}
}Usage
REST API Style
{
"method": "POST",
"endpoint": "guilds/123456789/roles",
"payload": {
"name": "Bot Master",
"permissions": "8",
"color": 3447003,
"mentionable": true
}
}Slash Command Style
{
"method": "POST",
"endpoint": "/role create name:Bot_Master color:blue permissions:8 mentionable:true guild_id:123456789"
}Examples
Create a role:
{
"method": "POST",
"endpoint": "/role create name:Moderator color:red permissions:moderate_members guild_id:123456789"
}Send a message:
{
"method": "POST",
"endpoint": "channels/123456789/messages",
"payload": {
"content": "Hello from the API!"
}
}Get server information:
{
"method": "GET",
"endpoint": "guilds/123456789"
}Recommendations:
Put server, channel and user IDs and some examples in project knowledge to avoid having to remind the model of those, along with something like this to get it started:
"Here's how to effectively use the Discord raw API tool: The tool is called discord_api and takes three parameters:
method: HTTP method ("GET", "POST", "PUT", "PATCH", "DELETE")
endpoint: Discord API endpoint (e.g., "guilds/{guild.id}/roles")
payload: Optional JSON object for the request body Key examples I've used:
Creating roles:
discord_api
method: POST
endpoint: guilds/{server_id}/roles
payload: {
"name": "Role Name",
"color": 3447003, // Blue color in decimal
"mentionable": true
}Creating categories and channels:
// Category
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
"name": "Category Name",
"type": 4 // 4 = category
}
// Text channel in category
discord_api
method: POST
endpoint: guilds/{server_id}/channels
payload: {
"name": "channel-name",
"type": 0, // 0 = text channel
"parent_id": "category_id",
"topic": "Channel description"
}Moving channels to categories:
discord_api
method: PATCH
endpoint: channels/{channel_id}
payload: {
"parent_id": "category_id"
}Sending messages:
discord_api
method: POST
endpoint: channels/{channel_id}/messages
payload: {
"content": "Message text with emojis \ud83d\ude04"
}Assigning roles:
discord_api
method: PUT
endpoint: guilds/{server_id}/members/{user_id}/roles/{role_id}
payload: {}The tool supports the full Discord API, so you can reference the Discord API documentation for more endpoints and features. The responses include IDs and other metadata you can use for subsequent requests. Pro tips:
Save IDs returned from creation requests to use in follow-up requests
Unicode emojis can be included directly in message content? Tell the model to use discord emoji like :champagne_glass: - Messages with unicode emoji hangs Claude Desktop?Channel types: 0 = text, 2 = voice, 4 = category, 13 = stage
Role colors are in decimal format (not hex)
Most modification endpoints use PATCH method
Empty payloads should be {} not null"
License
MIT License