Skip to main content
Glama
MCP Discord Bot Server

MCP Discord Bot Server

by AceDataCloud

MCP Discord Bot Server

A Model Context Protocol (MCP) server that provides tools for automating Discord through a self-hosted Discord Agent Proxy instance.

Overview

The Discord Agent Proxy is a standalone service you deploy on AceDataCloud. It maintains a persistent connection to Discord using your account credentials and exposes both an MCP and REST API interface.

This MCP server wraps the Discord Agent Proxy's REST API, exposing Discord operations as MCP tools for use with Claude, Cursor, and other MCP-compatible AI clients.

⚠️ Warning: Automating a personal Discord account (self-bot) violates Discord's Terms of Service. Use a dedicated account and keep automation frequency reasonable.

Related MCP server: Discord MCP Server

Prerequisites

  1. Create a Discord Agent Proxy application at platform.acedata.cloud and activate a subscription. Instance resources are configured automatically; no instance size selection is needed.

  2. Enter your Discord account credentials in the configuration page and deploy.

  3. In the application's Overview tab, confirm the account is connected and copy the MCP endpoint and access token from the Discord account card. A running container does not guarantee a connected Discord account.

The Documentation tab lists all 14 REST operations with request parameters, response schemas, and code examples. Test GET /api/whoami there, or call discord_whoami after configuring this MCP server, to verify the connected account. Instance addresses and access tokens are filled in automatically in the console; tokens are hidden by default. Sending, editing, or deleting messages affects the real account, so confirm the target and content before testing.

Download OpenAPI (JSON) exports the instance address without its access token. To change Discord account credentials, use Redeploy in Overview.

Connect to your Discord Agent Proxy

This package connects to your own deployed Discord Agent Proxy, not to the shared https://<service>.mcp.acedata.cloud/mcp endpoint used by the generation MCPs. The proxy's URL and access token are shown in the application's Overview tab after you deploy and connect the Discord account. The proxy credential is DISCORD_BOT_TOKEN; an AceDataCloud API token or MCP OAuth/DCR setup does not replace it.

Use a dedicated Discord account and follow Discord's current terms and rate limits. Sending, editing, deleting, and reacting affect that real account. Deployment and API documentation.

Local stdio setup

python -m pip install mcp-discord-bot
export DISCORD_BOT_BASE_URL='https://discord-bot-xxxxxxxxxxxx.app.acedata.cloud'
export DISCORD_BOT_TOKEN='YOUR_PROXY_TOKEN'
mcp-discord-bot

Copy the actual URL and token from your own application's Overview; the hostname above is only a shape example. Keep the token in your user's environment or secret store, never in a committed repo. For Claude Desktop, merge this entry into the local MCP file opened from its developer settings (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "discord-bot": {
      "command": "uvx",
      "args": ["mcp-discord-bot"],
      "env": {
        "DISCORD_BOT_BASE_URL": "YOUR_DEPLOYED_PROXY_URL",
        "DISCORD_BOT_TOKEN": "YOUR_PROXY_TOKEN"
      }
    }
  }
}

uvx needs uv on PATH; Claude Code, Cursor and VS Code can also launch this stdio command using their own local MCP configuration formats. Do not copy this local-process JSON into a remote connector screen.

Verify before sending

  1. Confirm the proxy application's Overview shows the Discord account connected. A running container alone is insufficient.

  2. Call the read-only discord_whoami tool and check the account identity. Then use discord_list_guilds or discord_list_channels to inspect the intended target.

  3. Only after confirming the destination, call a mutating tool such as discord_send_message. Review its output and reread the message if available. Keep the destination, content, and rate within the account's permissions.

If discord_whoami fails, check the proxy URL, proxy token and connected-account status. mcp-discord-bot --transport http --port 8000 runs your own HTTP MCP wrapper; it is not the shared hosted OAuth service. Expose that wrapper only with appropriate network and authentication controls.

Available Tools

Tool

Description

discord_whoami

View the proxied Discord account details

discord_list_guilds

List all servers the account has joined

discord_list_channels

List channels in a server

discord_create_text_channel

Create a new text channel

discord_list_members

List server members

discord_send_message

Send a message (with optional reply)

discord_read_messages

Read recent messages from a channel

discord_edit_message

Edit a message you sent

discord_delete_message

Delete a message

discord_search_messages

Search for messages in a channel

discord_add_reaction

Add an emoji reaction to a message

discord_pin_message

Pin a message in a channel

discord_create_dm

Open a DM channel with a user

discord_send_dm

Send a direct message to a user

discord_get_usage_guide

Get comprehensive usage documentation

Documentation

Documentation

License

MIT

Available Tools

15 tools
discord_add_reactionA

Add an emoji reaction to a Discord message.

Args:
    channel_id: The ID of the channel containing the message.
    message_id: The ID of the message to react to.
    emoji: The emoji to react with (Unicode or Discord custom emoji format).

Returns:
    JSON confirmation of the reaction being added.

Inputs: emoji (required), channel_id (required), message_id (required). Returns: result

discord_create_dmA

Open a direct message (DM) channel with a Discord user.

Creates or retrieves the DM channel with the specified user.

Args:
    recipient_id: The Discord user ID to open a DM with.

Returns:
    JSON object with the DM channel ID, which can be used with other tools.

Inputs: recipient_id (required). Returns: result

discord_create_text_channelC

Create a new text channel in a Discord guild (server).

Args:
    guild_id: The ID of the Discord guild.
    name: The name for the new text channel.

Returns:
    JSON object with the created channel details.

Inputs: name (required), guild_id (required). Returns: result

discord_delete_messageC

Delete a message from a Discord channel.

Args:
    channel_id: The ID of the channel containing the message.
    message_id: The ID of the message to delete.

Returns:
    JSON confirmation of deletion or error details.

Inputs: channel_id (required), message_id (required). Returns: result

discord_edit_messageA

Edit a message previously sent by the proxied Discord account.

Only messages sent by the proxied account can be edited.

Args:
    channel_id: The ID of the channel containing the message.
    message_id: The ID of the message to edit.
    content: The new text content for the message.

Returns:
    JSON object with the updated message details.

Inputs: content (required), channel_id (required), message_id (required). Returns: result

discord_get_usage_guideA

Get a comprehensive guide for using the Discord Bot tools.

Provides detailed information on how to use the Discord Bot MCP tools
effectively, including available tools, parameters, and examples.

Returns:
    Complete usage guide for Discord Bot tools.

Inputs: no named parameters. Returns: result

discord_list_channelsA

List all channels in a Discord guild (server).

Returns a list of all channels with their IDs, names, and types.

Args:
    guild_id: The ID of the Discord guild. Use discord_list_guilds to find guild IDs.

Returns:
    JSON array of channel objects.

Inputs: guild_id (required). Returns: result

discord_list_guildsA

List all Discord servers (guilds) the proxied account has joined.

Returns a list of all guilds with their IDs and names.

Returns:
    JSON array of guild objects with id and name.

Inputs: no named parameters. Returns: result

discord_list_membersC

List members of a Discord guild (server).

Args:
    guild_id: The ID of the Discord guild.
    limit: Maximum number of members to return (default: 100).

Returns:
    JSON array of member objects.

Inputs: guild_id (required), limit. Returns: result

discord_pin_messageC

Pin a message in a Discord channel.

Args:
    channel_id: The ID of the channel containing the message.
    message_id: The ID of the message to pin.

Returns:
    JSON confirmation of the message being pinned.

Inputs: channel_id (required), message_id (required). Returns: result

discord_read_messagesB

Read recent messages from a Discord channel.

Args:
    channel_id: The ID of the channel to read messages from.
    limit: Number of recent messages to return (default: 50, max: 100).

Returns:
    JSON array of message objects with author, content, and timestamp.

Inputs: channel_id (required), limit. Returns: result

discord_search_messagesC

Search for messages in a Discord channel.

Args:
    channel_id: The ID of the channel to search in.
    query: The search query string.
    limit: Maximum number of results to return (default: 25).

Returns:
    JSON array of matching message objects.

Inputs: query (required), channel_id (required), limit. Returns: result

discord_send_dmC

Send a direct message (DM) to a Discord user.

Args:
    recipient_id: The Discord user ID to send the DM to.
    content: The text content of the direct message.

Returns:
    JSON object with the sent message details.

Inputs: content (required), recipient_id (required). Returns: result

discord_send_messageC

Send a message to a Discord channel.

Args:
    channel_id: The ID of the channel to send the message to.
    content: The text content of the message.
    reply_to: Optional ID of a message to reply to.

Returns:
    JSON object with the sent message details.

Inputs: content (required), channel_id (required), reply_to. Returns: result

discord_whoamiA

Get information about the currently proxied Discord account.

Returns the account details including username, ID, and discriminator
for the Discord account connected to this Agent Proxy.

Returns:
    JSON object with the Discord account information.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 15 tools

    Disambiguation4/5

    Each tool targets a distinct resource and action, so selection is generally unambiguous. There is minor overlap between discord_create_dm (opens a DM channel) and discord_send_dm (which implicitly does the same plus sends), and send_message vs send_dm could be confused, but descriptions clarify the boundaries.

    Naming Consistency5/5

    Every tool follows a strict discord_verb_noun snake_case pattern (discord_send_message, discord_list_channels, discord_create_dm, etc.). The convention is uniform across all 15 tools with no deviations.

    Tool Count5/5

    At 15 tools the surface sits at the top of the well-scoped range and each tool maps to a concrete Discord operation. Nothing feels redundant enough to remove, and no important area is padded with trivial variants.

    Completeness4/5

    Core messaging lifecycle (send/read/edit/delete/search), channels, guilds, members, reactions, pins, and DMs are well covered. Minor gaps exist: no channel delete/rename, no unpin, and no reaction removal, but agents can work around most of these.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to send and read messages in Discord channels, manage servers, channels, and roles via Discord's API.
      14 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to send and read messages in Discord channels through the Discord API, with server and channel discovery.
      14 npm
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      MCP server that gives AI agents first-class access to Discord, enabling discovery, messaging, channel management, moderation, and arbitrary REST calls through typed, consent-aware tools.
      14 npm
      3
      MIT