Discord MCP Server

Instructions

Implementation Reference

• src/discord_mcp/core_tool_handlers.py:47-76 (handler)

  Core handler function that iterates over discord_client.guilds, collects server details (name, ID, member count, created_at, owner_id), formats a markdown list, and returns as TextContent. Handles empty case.
  @staticmethod async def handle_list_servers(discord_client, arguments: Dict[str, Any]) -> List[TextContent]: """List all servers the bot has access to""" servers_info = [] for guild in discord_client.guilds: servers_info.append({ "name": guild.name, "id": guild.id, "member_count": guild.member_count, "created_at": guild.created_at.strftime('%Y-%m-%d'), "owner_id": guild.owner_id }) if not servers_info: return [TextContent(type="text", text="No servers found. Make sure the bot is invited to servers.")] # Format the server list server_list = "\n".join([ f"**{server['name']}**\n" f" - ID: {server['id']}\n" f" - Members: {server['member_count']}\n" f" - Created: {server['created_at']}\n" for server in servers_info ]) return [TextContent( type="text", text=f"**Available Servers ({len(servers_info)}):**\n\n{server_list}" )]
• src/discord_mcp/integrated_server.py:928-937 (registration)

  Registers the 'list_servers' tool in the @app.list_tools() function with description and empty inputSchema (no args needed).
  Tool( name="list_servers", description="Get a list of all Discord servers the bot has access to with detailed information", inputSchema={ "type": "object", "properties": {}, "required": [] } ) ]
• src/discord_mcp/integrated_server.py:1021-1032 (registration)

  In @app.call_tool() dispatcher, includes 'list_servers' in core_tool_names list and dynamically calls CoreToolHandlers.handle_list_servers if matched.
  core_tool_names = [ "get_server_info", "list_servers", "get_channels", "list_members", "get_user_info", "send_message", "read_messages", "add_reaction", "add_multiple_reactions", "remove_reaction", "moderate_message", "create_text_channel", "delete_channel", "add_role", "remove_role" ] if name in core_tool_names: handler_method = f"handle_{name}" if hasattr(CoreToolHandlers, handler_method): return await getattr(CoreToolHandlers, handler_method)(discord_client, arguments)
• src/discord_mcp/integrated_server.py:20-20 (helper)

  Imports the CoreToolHandlers class containing the list_servers handler.
  from .core_tool_handlers import CoreToolHandlers