MCP Discord Bot Server
Provides tools for automating Discord through a self-hosted Discord Agent Proxy, enabling AI agents to view account details, list guilds and channels, create text channels, manage members, send/edit/delete/read/search messages, add reactions, pin messages, and manage direct messages.
Click on "Deploy 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., "@MCP Discord Bot Server send a message to #general saying the deploy is complete"
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.
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
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.
Enter your Discord account credentials in the configuration page and deploy.
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-botCopy 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
Confirm the proxy application's Overview shows the Discord account connected. A running container alone is insufficient.
Call the read-only
discord_whoamitool and check the account identity. Then usediscord_list_guildsordiscord_list_channelsto inspect the intended target.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 |
| View the proxied Discord account details |
| List all servers the account has joined |
| List channels in a server |
| Create a new text channel |
| List server members |
| Send a message (with optional reply) |
| Read recent messages from a channel |
| Edit a message you sent |
| Delete a message |
| Search for messages in a channel |
| Add an emoji reaction to a message |
| Pin a message in a channel |
| Open a DM channel with a user |
| Send a direct message to a user |
| Get comprehensive usage documentation |
Documentation
License
MIT
Available Tools
15 toolsdiscord_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
Scored across 15 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Read-only search of 2,189 AI agent tools (MCP servers, x402 APIs) with daily automated trust scores.
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to send and read messages in Discord channels, manage servers, channels, and roles via Discord's API.14 npm2MIT
- FlicenseNot gradedqualityDmaintenanceEnables LLMs to read messages, discover channels, send messages, and monitor Discord communities using the Discord HTTP API.-
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to send and read messages in Discord channels through the Discord API, with server and channel discovery.14 npmMIT
- AlicenseNot gradedqualityFmaintenanceMCP 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 npm3MIT