Skip to main content
Glama
Sign In
enesjakozh
Discord Raw API MCP Server

Discord Raw API MCP Server

by hanweg
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

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

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

  2. 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: poke_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

  1. Create a role:

{
    "method": "POST",
    "endpoint": "/role create name:Moderator color:red permissions:moderate_members guild_id:123456789"
}

  1. Send a message:

{
    "method": "POST",
    "endpoint": "channels/123456789/messages",
    "payload": {
        "content": "Hello from the API!"
    }
}

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

  1. method: HTTP method ("GET", "POST", "PUT", "PATCH", "DELETE")

  2. endpoint: Discord API endpoint (e.g., "guilds/{guild.id}/roles")

  3. payload: Optional JSON object for the request body Key examples I've used:

  4. Creating roles:

discord_api
method: POST
endpoint: guilds/{server_id}/roles
payload: {
    "name": "Role Name",
    "color": 3447003,  // Blue color in decimal
    "mentionable": true
}

  1. 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"
}

  1. Moving channels to categories:

discord_api
method: PATCH
endpoint: channels/{channel_id}
payload: {
    "parent_id": "category_id"
}

  1. Sending messages:

discord_api
method: POST
endpoint: channels/{channel_id}/messages
payload: {
    "content": "Message text with emojis \ud83d\ude04"
}

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

Available Tools

1 tool
discord_apiC

Execute raw Discord API commands. Supports both REST API calls and application commands.

Inputs: method (required), endpoint (required), payload.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

    TDQS

    B3/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'discord_api' has a clearly distinct purpose that covers all Discord API interactions.

    Naming Consistency5/5

    Since there is only one tool, naming consistency is inherently perfect. The tool name 'discord_api' follows a clear and appropriate pattern for its function.

    Tool Count2/5

    A single tool for a Discord API server is too few for the apparent scope, as Discord's API typically involves multiple resources and operations (e.g., channels, messages, users). This forces all functionality through one generic tool, which is a mismatch for the domain's complexity.

    Completeness1/5

    The tool surface is severely incomplete for a Discord API server. While the single tool can execute any raw API command, there are no specific tools for common Discord operations (e.g., send_message, get_channel, list_members), leaving significant gaps that will likely cause agent failures due to lack of structured guidance.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • poke_discord

      thesammykins
      F
      license
      Not graded
      quality
      C
      maintenance
      Enables interaction with Discord through natural language, including reading and sending messages, managing servers, and user actions.
      -

    • discord-mcp

      tanishqkancharla
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides full Discord REST API access through a bot token, enabling server management including channels, messages, members, roles, and more.
      190 npm
      1
      MIT

    • Discord MCP Server

      swarit-soni
      A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to interact with Discord through the REST API, supporting message reading and sending, channel and guild management, threads, pins, and reactions.
      17
      MIT

    Appeared in Searches