Discord MCP Server

Instructions

Implementation Reference

• src/discord_mcp/advanced_tool_handlers.py:557-570 (handler)

  Implements the timeout_member tool by fetching the guild and member, calculating timeout duration, applying the timeout, and returning a confirmation message.

  async def handle_timeout_member(discord_client, arguments: Dict[str, Any]) -> List[TextContent]:
      """Timeout a member"""
      guild = await discord_client.fetch_guild(int(arguments["server_id"]))
      member = await guild.fetch_member(int(arguments["user_id"]))
      
      duration = timedelta(minutes=arguments["duration_minutes"])
      member_name = member.display_name
      
      await member.timeout(duration, reason=arguments.get("reason", "Timed out via MCP"))
      
      return [TextContent(
          type="text",
          text=f"Timed out member {member_name} for {arguments['duration_minutes']} minutes\nReason: {arguments.get('reason', 'Timed out via MCP')}"
      )]

• src/discord_mcp/integrated_server.py:436-449 (schema)

  Defines the input schema and parameters for the timeout_member tool during registration.

  Tool(
      name="timeout_member",
      description="Temporarily timeout a member",
      inputSchema={
          "type": "object",
          "properties": {
              "server_id": {"type": "string", "description": "Server ID"},
              "user_id": {"type": "string", "description": "User ID to timeout"},
              "duration_minutes": {"type": "number", "description": "Timeout duration in minutes"},
              "reason": {"type": "string", "description": "Reason for timeout"}
          },
          "required": ["server_id", "user_id", "duration_minutes"]
      }
  ),

• src/discord_mcp/integrated_server.py:1015-1018 (registration)

  Dispatches calls to timeout_member (and other advanced tools) by dynamically invoking the corresponding handler method on AdvancedToolHandlers.

  if name in advanced_tool_names:
      handler_method = f"handle_{name}"
      if hasattr(AdvancedToolHandlers, handler_method):
          return await getattr(AdvancedToolHandlers, handler_method)(discord_client, arguments)