Discord Raw API MCP 서버

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 claude

Manual 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 .

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 : - 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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

discord_api

봇 관리, 서버 구성 및 메시지 작업을 위해 REST API 호출과 슬래시 명령 구문을 모두 사용하여 Discord API와 직접 상호 작용할 수 있습니다.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Discord MCP Server
v-3
-
security
F
license
-
quality
Enables LLMs to interact with Discord channels by sending and reading messages through Discord's API, with a focus on maintaining user control and security.
Last updated -
161
129
MCP-Discord
barryyip0625
A
security
A
license
A
quality
A Discord Model Context Protocol server that enables AI assistants to interact with Discord, providing functionality for sending messages, managing channels, handling forum posts, and working with reactions.
Last updated -
22
16
42
MIT License
Discord MCP Server
mastra-ai
-
security
F
license
-
quality
A Discord bot server that integrates with Mastra's MCP Bot component to provide intelligent assistance and answer questions about Mastra.ai through direct messages and slash commands.
Last updated -
161
1
Discord MCP Server
henishshah18
-
security
F
license
-
quality
A secure server that enables interaction with Discord channels through JWT-authenticated API calls, allowing users to send messages, fetch channel data, search content, and perform moderation actions.
Last updated -

View all related MCP servers

Discord Raw API MCP Server

Discord Raw API MCP Server

Installation

Installing via Smithery

Manual Installation

Configuration

Usage

REST API Style

Slash Command Style

Examples

Recommendations:

License

Tools

Related Resources

Related MCP Servers

Discord MCP Server

MCP-Discord

Discord MCP Server

Discord MCP Server

Appeared in Searches

New MCP Servers

MCP directory API