# Discord Bot MCP for AI Agents MCP > The Discord Bot MCP gives your AI agent total control over a community's backend systems. You can audit entire guilds, review channel structures, manage member lists, and send or delete messages directly from conversation. Stop jumping between dashboards; let your agent handle all real-time communication tasks. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** bot-management, server-administration, community-engagement, webhook, real-time-messaging ## Description Managing a large Discord community used to mean opening multiple developer consoles, manually running API calls, or wading through complex web dashboards. Now, you can just ask your AI client to do it. This MCP connects your bot's full power directly into your conversational workflow. Your agent acts as an instant moderator and administrator. Need to see every channel in a guild? Just ask. Want to know who is in the server or if someone was banned? Your agent checks the member lists and tells you. You can also send announcements across specific channels, or even clean up chat by deleting old messages. Whether you're running a support team or developing bot features, this MCP lets your agent handle data querying—from listing all guilds your bot belongs to, to getting detailed information about roles. It’s basically giving the AI instant admin privileges over your entire community ecosystem. Since Vinkius hosts thousands of specialized MCPs, adding this Discord Bot integration means you have a single point of control for everything related to real-time chat platforms. ## Tools ### list_messages Fetches and displays the most recent messages sent in a specific channel. ### delete_message Removes specified messages from any given Discord channel. ### get_channel Provides full details and metadata for a single, specific Discord channel. ### get_guild_roles Retrieves a list of all defined roles within a guild, including their associated permissions. ### get_guild Gathers comprehensive details about an entire Discord server (guild). ### get_me Returns authenticated information and status details for the connected bot account. ### list_channels Generates a list of all channels present within a specified guild. ### list_guild_members Pulls up the complete member roster for an entire guild, detailing profiles and status. ### list_guilds Lists every server that the connected bot account is currently a part of. ### send_message Sends custom, live messages into any target channel within Discord. ## Prompt Examples **Prompt:** ``` What are all the guilds my bot belongs to right now? ``` **Response:** ``` I checked the system and found that your bot is active in 4 servers. Here's a quick list: * **Vinkius Community**: (12,500 members) * **Dev Lounge**: (890 members) * **Support Hub**: (3,100 members) * **Marketing Team**: (450 members) You can ask me to audit any of these next. ``` **Prompt:** ``` Send a reminder about the meeting tomorrow in the #general channel. ``` **Response:** ``` **REMINDER:** The cross-functional team sync is scheduled for 9 AM EST tomorrow. Don't forget your prep work! (Message sent successfully to #general. ID: 789012345) ``` **Prompt:** ``` Who are the top 5 administrators in the main server? ``` **Response:** ``` I pulled the member list and checked roles for you. The top admins right now are: * @AdminUser (Role: Owner) * @SuperMod (Role: Moderator) * @TeamLeadX (Role: Admin) * @SupportGuy (Role: VIP) * @DevMaster (Role: Developer) Need me to check the specific permissions for any of these roles? ``` ## Capabilities ### Audit and list all associated guilds Retrieves comprehensive metadata for every server the bot is part of, including member counts and role structures. ### View and organize channel details Lists channels within a guild to keep track of the overall community structure. ### Manage messages in real time Sends new announcements or deletes unwanted historical messages in any specified channel. ### Inspect member profiles and lists Pulls up the current list of members for a guild, allowing you to track growth and participant details. ### Retrieve bot and user governance data Gathers specific information about the bot's own account or other users within the Discord environment. ## Use Cases ### Emergency Announcement During a service outage, the community manager doesn't have time to log into Discord settings. They simply ask their agent to 'Send maintenance starting in 10 minutes' to the #announcements channel using `send_message`, ensuring everyone gets the immediate notice. ### Security Audit A developer needs to check if a new role ('Premium Member') has been assigned correctly. Instead of checking role permissions manually, they ask their agent to use `get_guild_roles` and verify the permission bits instantly. ### Tracking Community Growth The operations lead needs a count of active users for reporting. They prompt their agent to 'List all guild members' using `list_guild_members`, getting a clean, queryable roster right in the chat. ### Structural Review A moderator wants to see if new channels were created but forgotten. They ask their agent to list all available channels and get detailed info on a specific one using `list_channels` and `get_channel`, keeping the community organized. ## Benefits - Stop wasting time context-switching. You can use the agent to list all guilds or audit channel structures without ever leaving your chat window. - Maintain full administrative oversight with tools like `list_guild_members` and `get_guild_roles`, giving you a real-time view of who's in the server and what permissions they have. - Handle real-time communication tasks immediately. Use `send_message` to make announcements or `delete_message` to clean up spam, all via natural language prompts. - The bot can act as an auditor using `get_guild` and `list_channels`, providing immediate metadata about the server's health and organization. - Gain full visibility into user status. The agent lets you query member lists or even get specific bot info with `get_me`, making governance simple. ## How It Works The bottom line is, you talk to your AI assistant like talking to a colleague, and it performs complex backend operations on Discord without needing any manual setup or terminal commands. 1. Subscribe to this MCP on Vinkius and input your unique Discord Bot Token. 2. Connect your preferred AI client (Cursor, Claude, etc.) to the configured MCP. 3. Ask your agent a question—like 'List all channels in Dev Lounge'—and it executes the command instantly. ## Frequently Asked Questions **How do I use the Discord Bot MCP for AI Agents to audit my community?** This MCP lets your agent run full audits on your server. You can ask it to list all guilds or get detailed metadata about channels and roles, giving you a complete picture of your community's structure. **Can the Discord Bot MCP help me with daily member management tasks?** Yes. Your agent handles everything from listing every guild member to getting detailed bot user info. It makes tracking growth and managing profiles as simple as asking a question in chat. **Is the Discord Bot MCP good for sending out mass announcements?** Absolutely. You can use your agent to send messages to specific channels, perfect for time-sensitive updates or announcements across multiple groups without manual intervention. **Does this MCP let me clean up old messages in Discord?** Yes, you can instruct the agent to delete messages from a channel. This is useful for removing spam or archiving outdated chat history when needed. **What if I want to check out all the different channels in my server?** You simply tell your agent to list all available channels. It provides an organized catalog of every channel, helping you maintain a clear view of your community's organization. **Does connecting the Discord Bot MCP require developer skills?** No. You don't need to write code or use APIs. The AI agent handles all the complex connections; you just talk to it naturally and tell it what action you want done.