Discord Vencord MCP Bridge
Enables AI agents to interact with a user's Discord account through the native Discord desktop client, including reading and sending messages, managing DMs and friends, reacting to messages, navigating channels, administering servers and channels, managing roles, moderation actions, and invite management.
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., "@Discord Vencord MCP Bridge Send a message in #general saying standup moved to 3pm"
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 Vencord MCP Bridge
Model Context Protocol (MCP) server for Discord user sessions. Enables Claude Desktop, Antigravity, Cursor, and any MCP-compatible AI agent to interact with Discord directly through your native desktop client.
Why This Exists
Traditional Discord MCP tools require providing a Bot Token or extracting your User Token.
Bot Tokens cannot send messages in DMs without mutual servers or read your private chats.
User Tokens in external scripts frequently trigger Cloudflare challenges, phone locks, and account flags due to TLS fingerprint mismatch (JA3/TLS, WebSockets heartbeat, super-properties).
This project routes all actions natively through your active Discord client via a local Vencord userplugin.
Zero Account Flagging: Runs inside your authentic Discord Electron runtime.
No Tokens in Config Files: Authenticates automatically using your client's existing session.
30+ Tools: Read channels, send replies, react, list DMs, manage servers, kick/ban, and manage roles.
Related MCP server: discord-mcp-server
Architecture
[ AI Assistant (Claude Desktop / Antigravity / Cursor) ]
│ (stdio)
▼
[ Node.js MCP Server (This Repo) ]
[ WebSocket Server: 127.0.0.1:49152 ]
│ (Local WebSocket JSON Bridge)
▼
[ Vencord UserPlugin (MCPBridge) ]
[ Inside Discord Desktop (Renderer Context) ]
│ (Discord Internal Webpack Stores & RestAPI)
▼
[ Discord Gateway ]Quick Start Guide
Step 1: Clone and Build the MCP Server
git clone https://github.com/clawdecode/discord-vencord-mcp.git
cd discord-vencord-mcp
npm install
npm run buildStep 2: Install the Vencord Plugin
Ensure you have the Vencord Dev Build (or clone Vencord):
git clone https://github.com/Vendicated/Vencord.git cd Vencord pnpm installCopy the plugin file from this repository into Vencord's userplugins directory:
mkdir src\userplugins\mcpBridge copy "path\to\discord-vencord-mcp\vencord-plugin\index.tsx" "src\userplugins\mcpBridge\index.tsx"Build and inject into Discord:
pnpm build pnpm injectOpen Discord and verify MCPBridge is visible under User Settings -> Vencord -> Plugins (tagged with the USERPLUGIN badge) and enabled. Press
Ctrl + Rto reload.
Step 3: Register in Your MCP Client
Add the server to your client configuration file:
Antigravity (~/.gemini/config/mcp_config.json)
{
"mcpServers": {
"discord-bridge": {
"command": "node",
"args": [
"C:/path/to/discord-vencord-mcp/dist/mcp-server/index.js"
]
}
}
}Claude Desktop (%APPDATA%/Claude/claude_desktop_config.json)
{
"mcpServers": {
"discord-bridge": {
"command": "node",
"args": [
"C:/path/to/discord-vencord-mcp/dist/mcp-server/index.js"
]
}
}
}Cursor (.cursor/mcp.json)
{
"mcpServers": {
"discord-bridge": {
"command": "node",
"args": [
"C:/path/to/discord-vencord-mcp/dist/mcp-server/index.js"
]
}
}
}Complete Tools Reference
Identity and Private Messages
Tool | Description |
| Test bridge connectivity and verify authenticated user. |
| Look up account details by User ID or self. |
| Retrieve your entire Discord friends list. |
| List all active direct message channels and group DMs. |
| Retrieve existing DM thread with a user (or open one). |
Messaging and Reactions
Tool | Description |
| Read the last N messages with attachments and authors. |
| Query a single message by ID. |
| Send a message as yourself to any channel or DM. |
| Reply directly to a specific message ID. |
| Edit one of your previous messages. |
| Delete a message. |
| React to a message with an emoji. |
| Remove your reaction from a message. |
Navigation and UI Control
Tool | Description |
| Return the channel currently focused in your client. |
| Return the server currently focused in your client. |
| Switch your active desktop client view to any channel or DM. |
Server and Channel Administration
Tool | Description |
| List all servers your account belongs to. |
| Detailed server statistics, vanity URL, and settings. |
| Update server name, description, verification tier. |
| List text channels, voice channels, and categories. |
| Create new text (0), voice (2), or category (4) channels. |
| Modify name, topic, slowmode, and NSFW settings. |
| Delete any channel or category. |
Roles and Permissions
Tool | Description |
| Inspect server roles, permissions, hoist, and colors. |
| Create roles with custom names, hex colors, and bitwise permissions. |
| Update role color, name, hoist, and mentionability. |
| Delete a server role. |
| Add a role to a server member. |
| Strip a role from a server member. |
Moderation and Invites
Tool | Description |
| List members in a server. |
| Change nickname, server mute/deaf, or apply timeouts. |
| Kick a user with audit log reason. |
| Ban a user with optional message purge duration. |
| Revoke a server ban. |
| List active server invite links and usage counts. |
| Create an invite link with custom age and max uses. |
| Revoke an invite code. |
Security and Privacy
Local-Only Communication: The WebSocket bridge binds strictly to loopback (
127.0.0.1:49152) and never accepts outside network connections.Permission Parity: The tools operate under your user account's actual Discord permissions. It cannot bypass server role hierarchies or access channels your account cannot see.
No External Telemetry: All data flows exclusively between your local AI agent, the local MCP process, and your local Discord client.
License
Released under the MIT License.
Available Tools
38 toolsdiscord_add_reactionC
Add an emoji reaction to a message.
Inputs: emoji (required), message_id (required), channel_id.
discord_assign_roleC
Assign a role to a server member.
Inputs: role_id (required), user_id (required), guild_id.
discord_ban_memberC
Ban a user from a server.
Inputs: user_id (required), guild_id, delete_message_seconds.
discord_create_channelA
Create a new channel in a server (requires MANAGE_CHANNELS permission).
Inputs: name (required), type, topic, guild_id, +1 more.
discord_create_dmA
Get existing DM channel ID for a user or open one if not already created.
Inputs: user_id (required).
discord_create_inviteC
Create an invite for a channel.
Inputs: max_age, max_uses, temporary, channel_id.
discord_create_roleB
Create a new role in a server (requires MANAGE_ROLES permission).
Inputs: name, color, hoist, guild_id, +2 more.
discord_delete_channelA
Delete a channel from a server (requires MANAGE_CHANNELS permission).
Inputs: channel_id (required).
discord_delete_inviteC
Delete/revoke an invite code.
Inputs: code (required).
discord_delete_messageC
Delete a message from a channel.
Inputs: message_id (required), channel_id.
discord_delete_roleB
Delete a role from a server (requires MANAGE_ROLES permission).
Inputs: role_id (required), guild_id.
discord_edit_messageB
Edit one of your previously sent messages.
Inputs: content (required), message_id (required), channel_id.
discord_get_channel_infoA
Get metadata for a specific Discord channel by ID.
Inputs: channel_id.
discord_get_current_channelB
Get details about the channel currently open / selected in your Discord client.
Inputs: no named parameters.
discord_get_current_guildA
Get details of the Discord server/guild currently selected.
Inputs: no named parameters.
discord_get_guild_detailsC
Get comprehensive details and settings of a server/guild.
Inputs: guild_id.
discord_get_message_by_idB
Fetch a specific message by its ID.
Inputs: message_id (required), channel_id.
discord_get_recent_messagesB
Fetch recent messages in the active or target channel.
Inputs: limit, channel_id.
discord_get_user_infoB
Fetch profile details for yourself or another user by ID.
Inputs: user_id.
discord_kick_memberC
Kick a member from a server.
Inputs: user_id (required), reason, guild_id.
discord_list_dm_channelsB
List all existing direct message channels and group DMs with recipients.
Inputs: no named parameters.
discord_list_friendsC
List your friends on Discord.
Inputs: no named parameters.
discord_list_guild_channelsB
List all channels in a server.
Inputs: guild_id.
discord_list_guild_membersB
List members in a server (requires appropriate permissions/intent).
Inputs: limit, guild_id.
discord_list_guildsA
List all Discord servers (guilds) you are currently a member of.
Inputs: no named parameters.
discord_list_invitesB
List all active invites for a server.
Inputs: guild_id.
discord_list_rolesC
List all roles in a server.
Inputs: guild_id.
discord_modify_channelC
Modify an existing channel (name, topic, NSFW, parent category, slowmode).
Inputs: name, nsfw, topic, parent_id, +2 more.
discord_modify_guildB
Modify server settings (requires MANAGE_GUILD permission).
Inputs: name, guild_id, description, verification_level, +1 more.
discord_modify_memberC
Modify a member's nickname, mute/deaf state, or apply a timeout.
Inputs: user_id (required), deaf, mute, nick, +2 more.
discord_modify_roleC
Modify an existing role's name, color, hoist, or mentionable status.
Inputs: role_id (required), name, color, hoist, +2 more.
discord_remove_reactionC
Remove your emoji reaction from a message.
Inputs: emoji (required), message_id (required), channel_id.
discord_remove_roleC
Remove a role from a server member.
Inputs: role_id (required), user_id (required), guild_id.
discord_reply_messageC
Reply directly to a specific message in Discord.
Inputs: content (required), message_id (required), channel_id.
discord_send_messageA
Send a message as your authenticated Discord user into the current or specified channel.
Inputs: content (required), channel_id.
discord_statusA
Check if the Discord Vencord bridge is online and view the authenticated user.
Inputs: no named parameters.
discord_switch_channelB
Switch the active channel view in your Discord desktop client to a target channel.
Inputs: channel_id (required), guild_id.
discord_unban_memberC
Remove a ban for a user in a server.
Inputs: user_id (required), guild_id.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 38 tools
Most tools target distinct resources/actions (channels, roles, messages, members, invites), and descriptions clarify boundaries. Minor overlaps exist, such as discord_list_dm_channels vs discord_create_dm (which also opens existing DMs), and discord_get_current_channel vs discord_get_channel_info, but these are not severe.
Nearly all tools follow a clear discord_verb_noun snake_case pattern, making actions predictable. The main deviation is discord_status, which is noun-only, plus some noun-heavy names like discord_get_current_guild, but overall consistency is strong.
At 38 tools, the surface is heavy for a Discord bridge and exceeds the typical 3-15 well-scoped range. Many CRUD tools are individually justified, but the set is large enough to increase selection burden and cognitive load for an agent.
Core Discord operations are well covered across guilds, channels, roles, members, invites, reactions, DMs, and message CRUD. Notable gaps remain around threads, message search/pins, webhooks, emoji/sticker management, and audit logs, but agents can work around most core workflows.
Maintenance
Related MCP Connectors
Discord MCP server for ChatGPT, Claude and any AI agent: list servers and channels, read channel messages, search messages, send message, reply to message, send DM, read mentions and assign role in your own Discord account. Cotlet works in the account through your Cloud Browser, a real Chrome where you sign in to Discord yourself; Cotlet does not store your password and you need no Discord API key. About the official Discord API: Yes, Discord has an official API for bots and OAuth2 apps, but it acts as a bot that a server manager adds, not as you, and Discord has no official MCP server for it (checked 5 Nov 2026). The MCP server on Discord's docs site only searches documentation. Setup and FAQ: https://cotlet.dev/integrations/discord-api-mcp-server
Official MCP server for Agentwork — delegate tasks to AI agents with human-in-the-loop
An MCP server that integrates with Discord to provide AI-powered features.
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Related MCP Servers
- AlicenseAqualityCmaintenanceAn MCP server that provides native Discord tools for Claude Code, enabling bidirectional communication with remote agents or humans via the Discord REST API. It allows users to send messages, read channel history, and manage reactions directly from their local environment.63MIT
- AlicenseNot gradedqualityDmaintenanceLets any MCP-compatible AI client interact with Discord — send messages, manage channels, create webhooks, assign roles, and more.95 npm2MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that gives AI agents full admin control over Discord servers with 59 tools for messaging, moderation, roles, channels, forums, reactions, files, and more, deployed on Cloudflare Workers.8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to communicate with humans through Discord. Agents can send messages, create threads, wait for replies, and manage conversations across any MCP client.6 npmISC